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Introduction 


This reference guide aims to provide a comprehensive and 
detailed explanation of every command in the FUZE BASIC 
library. 


It is an evolving document because FUZE BASIC is constantly 
being updated and improved. To download the latest version 
please visit the resources section on the www.fuze.co.uk 
website. 


FUZE BASIC is currently available for Microsoft Windows®, 
Raspberry Pi, The FUZE and Linux. We hope to add Android in 
the coming months and possibly Mac OSx & iOS versions too. 


Listed alongside each command is a series of operating system 


icons highlighted to show which OS the command is 
compatible with. For example; 


ANALOGREAD 


displays AS [F | 
an 43 


The direct analog commands require the FUZE |O Board 
because it has a built in analog chip whereas the Raspberry Pi 
does not have one as standard. 


SENSEPLOT dspiys SM A) 83, F | 


..because this command will work on a standalone Pi anda 
FUZE with a senseHAT connected. 


Introduction 


Here at FUZE we’re constantly adding new commands and 
features so it is worth checking the resource pages on the FUZE 
website for new versions from time to time. 


Installing FUZE BASIC 


For details on installing and getting started we highly 
recommend you begin with the FUZE BASIC Project Workbook 
which can be downloaded for free from the FUZE website. 


The website also has many other tutorials, examples and 
projects. You are encouraged to contribute more to help fellow 
coding students. 


Community 


We really hope you enjoy using FUZE BASIC as much as we do. 
While it is intended as a language to learn coding with rather 
than one you would expect to use in a professional environment, 
it is unquestionably very powerful and flexible. As such it makes 
an ideal steppingstone between visual coding platforms like 
Scratch and more complex professional languages like C++, Java, 
PHP and so on. 


If you find yourself becoming quite proficient at FUZE BASIC then 
why not shew-eff er.. share your work on the FUZE website. At 
the very least you'll be helping others to progress. 


Many thanks from teamFUZE 
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Immediate mode Commands CLEAR 


CLEAR 4 
CLS 5 Purpose 
Clear variable memory. 
CONT 5 
CONTINUE 6 ce 
DIR 6 
EDIT Zz Description 
EXIT 7 Clears all variables and deletes all arrays. It also removes 
LIST j any active sprites from the screen. Stopped programs may 
not be continued after a CLEAR command. 
LISTGAMEPADS 8 
LOAD 8 Example 
NEW 9 REM Immediate Mode 
VARIABLE=10 
RUN 9 PRINT VARIABLE 
SAVE 10 CLEAR 
TROFF 10 REM Unassigned variable error! 
TRON 11 PRINT VARIABLE 
VERSION ull Associated 
NEW 
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CLS 


Purpose 
Clear the video display screen. 


Syntax 
CLS 


Description 

Clears the video display screen and places the cursor in 
the top left corner. The background is set to the current 
background (PAPER) colour. 


Example 

PAPER=WHITE 
INK=BLACK 

CLS 

PRINT "Hello World" 
END 


Associated 
CLS2, INK, PAPER, UPDATE 
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Immediate mode Commands 


CONT 


Purpose 
Continue running a program that has been stopped. 


Syntax 
CONT 


Description 
Continues program execution after a STOP instruction. 
Variables are not cleared. 


Example 
REM Immediate mode 
CONT 


Associated 
STOP 


— ar 
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CONTINUE 


Purpose 
Continue a loop. 


Syntax 
CONTINUE 


Description 

Will cause the loop to re-start at the line containing the 
LOOP instruction, continuing a FOR instruction and re- 
evaluating any WHILE or UNTIL instructions. 


Example 
REM Prints 1 to 10 but skips over 5 
FOR I=1 to 1@ LOOP 
IF (I=5) THEN CONTINUE 
PRINT I 
REPEAT 
END 


Associated 
BREAK, LOOP, LOOP REPEAT, FOR REPEAT, REPEAT 


UNTIL, UNTIL REPEAT, WHILE REPEAT 
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Immediate mode Commands 


DIR 


Purpose 
List FUZE BASIC program files in the current or specified 
directory. 


Syntax 
DIR [directory ] 


Description 

Lists the program files in your current working directory or 
the optional specified directory. These will have the .fuze 
file extension. 


Example 
REM Immediate Mode 
DIR 


Associated 
LOAD, SAVE 
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Immediate mode Commands 


EDIT LIST 


Purpose Purpose 

Edit the program in memory. List the program stored in memory to the screen. 
Syntax Syntax 

EDIT LIST 

Description Description 

Edits the program in memory using a full screen editor. This lists the program stored in memory to the screen. 
Example You can pause the listing with the space-bar and 


REM Tnniediate wade terminate it with the escape key. 


EDIT mal a7, Example 
By Oy REM Immediate Mode 
LIST 


Purpose 
Exit FUZE BASIC and return to the environment. 


Syntax 
EXIT 


Description 
Exit FUZE BASIC and return to the environment you started it 
in. 


Example 
REM Immediate mode 


EXIT 
Kd rape 27, main index rg 
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LISTGAMEPADS 


Purpose 
To display any connected joysticks and gamepads. 


Syntax 
LISTGAMEPADS 


Description 

This lists, by name, any attached joystick devices that 
are currently connected via USB or wireless USB, if 
supported by the OS. 


Example 
REM Immediate Mode 
LISTGAMEPADS 
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Immediate mode Commands 


LOAD 


Purpose 
Load a program into memory. 


Syntax 
LOAD filenameg 


Description 

Loads in a program from the local non-volatile storage. As 
with SAVE, you need to supply the filename without any 
quotes. Do not include the .fuze file extension. Note, if 
your filename has spaces then you must enter it within 
quoatation marks. LOAD "my game" for example. 


Example 

REM Immediate Mode 
LOAD demos/ball 
RUN 


Associated 
SAVE 


Cx) ini 
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NEW 


Purpose 
Start a new program 


Syntax 
NEW 


Description 
Deletes the program in memory. There is no verification 
and once it’s gone, it’s gone. Remember to save first! 


Example 

REM Immediate Mode 

NEW 

REM List will now be empty 
LIST 


Associated 
CLEAR 
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Immediate mode Commands 


RUN 


Purpose 
Runs the program in memory. 


Syntax 
RUN 


Description 
Runs the program in memory. Note that using RUN will 
clear all variables. 


Example 
REM Immediate Mode 
RUN 
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SAVE 


Purpose 
Saves your program to the local non-volatile storage. 


Syntax 
SAVE filename$ 


Description 

Saves your program to the local non-volatile storage. The 
filenameS is the name of the file you wish to save and 
may not contain spaces. If you have already saved a file, 
then you can subsequently execute SAVE without the 
filename and it will overwrite the last file saved. (This is 
reset when you load a new program or use the NEW 
command) 


Example 
REM Immediate Mode 
SAVE testprog 


Associated 
LOAD 
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Immediate mode Commands 


TROFF 


Purpose 
Disables TRON 


Syntax 
TROFF 


Description 
If TRON is enabled then TROFF switches it off. 


Example 
REM Immediate Mode 
TROFF 


Associated 
TRON 
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TRON 


Purpose 
Enables TRON mode for debugging. 


Syntax 
TRON 


Description 


Switching TRON on has a very dramatic effect. Running your 
program when TRON is enabled displays a section of code on 
screen to show exactly which line is being executed. 


You can adjust TRON settings with the following controls; 


CTRL+ UP / DOWN to change speed 

CTRL+ LEFT to Pause (hold down) 

CTRL+ LEFT + RIGHT to step 

CTRL+ RIGHT toggle transparent 

CTRL+ SHIFT + UP toggle TRON display 

CTRL+ PAGEUP increase number of lines displayed 
CTRL+ PAGEDOWN decrease number of lines displayed 
CTRL+ SHIFT + PAGEUP move TRON display up 

CTRL+ SHIFT + PAGEDOWN move TRON display down 


Example 
REM Immediate Mode 
TROFF 


Associated 
TRON 
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Immediate mode Commands 


VERSION 


Purpose 
Print the current version of FUZE BASIC. 


Syntax 
VERSION 


Description 
Print the current version of FUZE BASIC. 


Example 
REM Immediate Mode 
VERSION 


Ce) . . 
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Functions, Constants & Procedures 


ABS 

ACOS 
ADVANCESPRITE 
ANALOGREAD 
ANALOGWRITE 
ARMBODY 
ARMELBOW 
ARMGRIPPER 
ARMLIGHT 
ARMRESET 
ARMSHOULDER 
ARMWRIST 

ASC 

ASIN 

ATAN 

BREAK 

CHRS 

CIRCLE 
CLEARKEYBOARD 
CLOCK 
CLONESPRITE 
CLOSE 

CLS 

CLS2 

COLOUR 
COPYREGION 
COs 


14 
14 
a5 
(i 
16 
16 
17 
AZ 
18 
18 
19 
19 
20 
20 
21 
21 
22 
22 
23 
23 
24 
24 
25 
25 
26 
27 
28 


LOOP 

LOOP REPEAT 
DATA 

DATES 

DEF FN 

DEF PROC 
DEFCHAR 

DEG 
DIGITALREAD 
DIGITALWRITE 
DIM 
DRCANALOGREAD 
DRCCLOSE 
DRCDIGITALREAD 
DRCDIGITALWRITE 
DRCOPEN 
DRCPINMODE 
DRCPWMWRITE 
ELLIPSE 

ELSE 

END 

ENDIF 

ENDPROC 
ENVELOPE 

EOF 

EXP 

FADEOFF 


28 
29 
29 
30 
31 
31 
32 
32 
33 
33 
34 
35 
35 
36 
36 
37 
37 
38 
38 
39 
39 
40 
40 
41 
42 
42 
43 


FADEON 
FADING 
FALSE 

FFWD 

FN 

FONTSIZE 
FOR REPEAT 
FREEIMAGE 
FULLSCREEN 
GET 

GETS 
GETIMAGEH 
GETIMAGEW 
GETMOUSE 
GETPIXEL 
GETPIXELRGB 
GETSPRITEANGLE 
GETSPRITEH 
GETSPRITEW 
GETSPRITEX 
GETSPRITEY 
GHEIGHT 
GRABREGION 
GWIDTH 
HIDESPRITE 
HLINE 

HTAB 

HVTAB 

IF THEN 


43 
44 
44 
45 
45 
46 
46 
47 
47 
48 
48 
49 
49 
50 
50 
51 
51 
52 
52 
53 
53 
54 
54 
55 
55 
56 
56 
57 
57 


INK 

INKEY 
INPUT 
INPUT# 

INT 

LEFT 

LEFTS 

LEN 

LINE 

LINETO 
LOADIMAGE 
LOADMUSIC 
LOADSAMPLE 
LOADSPRITE 
LOCAL 

LOG 

MAX 

MIDS 

MIN 
MOUSEOFF 
MOUSEON 
MOUSEX 
MOUSEY 
MOVE 
MOVETO 
NEWSPRITE 
NUMFORMAT 
OPEN 
ORIGIN 
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58 
58 
59 
59 
60 
60 
61 
61 
62 
62 
63 
63 
64 
64 
65 
65 
66 
66 
67 
67 
68 
68 
69 
69 
70 
70 
71 
72 
72 
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PAPER 
PAPEROFF 
PAPERON 
PAUSECHAN 
PAUSEMUSIC 
PENDOWN 
PENUP 

Pl 

PINMODE 
PLAYMUSIC 
PLAYSAMPLE 
PLOT 
PLOTIMAGE 
PLOTSPRITE 
POLYEND 
POLYPLOT 
POLYSTART 
PLOTTEXT 
PRINT 

PRINT# 
PRINTAT 
PROC 
PWMWRITE 
RAD 

READ 

RECT 

REPEAT UNTIL 
RESTORE 
RESUMECHAN 
RESUMEMUSIC 


73 
73 
74 
74 
75 
75 
76 
76 
77 
77 
78 
78 
79 
79 
80 
80 
81 
81 
82 
82 
83 
83 
84 
84 
85 
85 
86 
86 
87 
87 


REWIND 
RGBCOLOUR 
RIGHT 

RIGHTS 
ROTATEIMAGE 
RND 
SAVEREGION 
SAVESCREEN 
SCALEIMAGE 
SCANKEYBOARD 
SCLOSE 
SCROLLDOWN 
SCROLLLEFT 
SCROLLRIGHT 
SCROLLUP 

SEED 

SEEK 
SENSEACCELX 
SENSEACCELY 
SENSEACCELZ 
SENSECLS 
SENSECOMPASSX 
SENSECOMPASSY 
SENSECOMPASSZ 
SENSEGETRGB 
SENSEGYROX 
SENSEGYROY 
SENSEGYROZ 
SENSEHEIGHT 
SENSEHFLIP 


88 
88 
89 
89 
90 
90 
91 
92 
92 
93 
93 
94 
94 
94 
94 
95 
95 
96 
96 
96 
96 
97 
97 
97 
97 
98 
98 
98 
98 
99 


SENSEHUMIDITY 
SENSELINE 
SENSEPLOT 
SENSEPRESSURE 
SENSERECT 
SENSERGBCOLOUR 
SENSESCROLL 
SENSETEMPERATURE 
SENSEVFLIP 
SETCHANVOL 
SETMODE 
SETMOUSE 
SETMUSICVOL 
SETSPRITEALPHA 
SETSPRITEANGLE 
SETSPRITEFLIP 
SETSPRITEORIGIN 
SETSPRITESIZE 
SETSPRITETRANS 
SGET 

SGETS 

SGN 

SHOWKEYS 

SIN 
SOFTPWMWRITE 
SOPEN 

SOUND 

SPACES 
SPRITECOLLIDE 
SPRITECOLLIDEPP 


99 
100 
100 
101 
101 
102 
102 
103 
103 
104 
104 
105 
105 
106 
106 
107 
107 
108 
108 
109 
110 
110 
111 
111 
112 
112 
113 
113 
114 
115 


SPRITEOUT 
SPUT 
SPUTS 
SQRT 
SREADY 
STOP 
STOPCHAN 
STOPMUSIC 
STRS 
SWAP 
SWITCH 
TAN 
TANGLE 
THEIGHT 
TIME 


TIMES 

TONE 
TRIANGLE 
TRUE 

TWIDTH 
UPDATEMODE 
UNTIL REPEAT 
UPDATE 

VAL 

VLINE 

VTAB 

WAIT 

WHILE REPEAT 
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ABS 


Purpose 
Return the absolute value of the argument. 


Syntax 
positivenumber=ABS (number ) 


Description 
Returns the absolute value of the supplied argument 


number i.e. If the argument is negative, make it positive. 


Example 

PRINT FN ElapsedYears(1966, 2013) 
PRINT FN ElapsedYears(2013,1966) 
END 

REM Return Number of years elapsed 
REM Between two dates 

DEF FN ElapsedYears(Year1, Year2) 
=ABS(Year1-Year2) 


Associated 
SGN 
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Functions, Constants & Procedures 


ACOS 


Purpose 
Returns the arc cosine of the supplied argument. 


Syntax 
angle=ACOS( cosine) 


Description 
This is the inverse of the COS function returning the angle 
for a given cosine. 


Example 

PRINT "Angle with cosine = @.5: " 
DEG 

REM 60 Degrees 

PRINT "In Degrees: ";ACOS(@.5) 
RAD 

REM PI/3 Radians 

PRINT "In Radians: "; ACOS(@.5) 


CLOCK 

PRINT "In Minutes: "; ACOS(@.5) 
END 

Associated 


ATAN, COS, SIN, TAN 
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ADVANCESPRITE 


Purpose 
Advances a sprite a specified amount 


Syntax 
ADVANCESPRITE( sprite, distance ) 


Description 
Moves a sprite forward by the specified distance. The 


direction is set by the SETSPRITEANGLE function. This is 
very useful when used with rotating sprites. 


Example 

pic = NEWSPRITE( 1 ) 
LOADSPRITE("logo.bmp", pic,@) 

PLOTSPRITE( pic, gWidth / 2, gHeight / 2, @ ) 
FOR angle = @ TO 360 LOOP 

SETSPRITEANGLE( pic, angle ) 
ADVANCESPRITE( pic, 5 ) 

UPDATE 

REPEAT 

END 


Associated 
PLOTSPRITE, SETSPRITEANGLE 
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Functions, Constants & Procedures 


ANALOGREAD 


Purpose 
Returns the value from an analog input. 


Syntax 
ANALOGREAD(@) 


Description 


Returns the a value of between 0 and 255 (OV & 3.3V) from 
the specified analog pin. There are four inputs, 0 to 3. 


Example 

REM Attach an LDR to 3.3V and analog pin @ 
PRINT analogRead(@) 

REM cover the LDR and run again. 

END 


Associated 
ANALOGREAD, ANALOGWRITE 
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ANALOGWRITE 


Purpose 
Sends a value to the analog output. 


Syntax 
ANALOGWRITE (@, value) 


Description 


Sends a voltage between OV and 3.3V (as a value of 0 to 
255) to analog pin O. There is one analog output. 


Example 


REM Attach an LED to analog OUT pin ® (the 
longer leg) and the shorter leg to GND 
LOOP 

FOR volt= @ TO 255 LOOP 
analogwWrite(@,volt) 

REPEAT 

REPEAT 

END 


Associated 
ANALOGREAD, ANALOGWRITE 
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Functions, Constants & Procedures 


ARMBODY 


Purpose 
Move the robot arm body. 


Syntax 
ARMBODY (direction) 


Description 

Activates the motor in the base of the robot arm 
according to the direction argument as follows: 
1 Move clockwise 

0 Stop 

-1 Move anti-clockwise. 


Example 

REM Move the body for 2 seconds clockwise 
ARMBODY (1) 

WAIT(2) 

ARMBODY (@) 

END 


Associated 
ARMELBOW, ARMGRIPPER, ARMLIGHT, ARMRESET, 


ARMSHOULDER, ARMWRIST 
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ARMELBOW 


Purpose 
Move the robot arm elbow. 


Syntax 
ARMELBOW( direction) 


Description 

Activates the motor in the elbow of the robot arm 
according to the direction argument as follows: 

1 Move clockwise 

0 Stop 

-1 Move anti-clockwise. 


Example 

REM Move the elbow for 1s anti-clockwise 
ARMELBOW( -1) 

WAIT (1) 

ARMELBOW(@) 

END 


Associated 
ARMBODY, ARMGRIPPER, ARMLIGHT, ARMRESET, 


ARMSHOULDER, ARMWRIST 
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Functions, Constants & Procedures 


ARMGRIPPER 


Purpose 
Open or close the robot arm gripper. 


Syntax 
ARMGRIPPER(direction) 


Description 

Activates the motor in the gripper of the robot arm 
according to the direction argument as follows: 

1 Open gripper 

0 Stop 

-1 Close gripper 


Example 

REM Open the gripper for 1 seconds 
ARMGRIPPER(1) 

WAIT(1) 

ARMGRIPPER(@) 

END 


Associated 
ARMBODY, ARMELBOW, ARMLIGHT, ARMRESET, 


ARMSHOULDER, ARMWRIST 


Cx ini 
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ARMLIGHT 


Purpose 
Switch the robot's LED on or off. 


Syntax 
ARMLIGHT (switch) 


Description 
If the switch argument is 1 then the LED is illuminated and 
if it is O it is switched off. 


Example 
REM Flash the LED with 1 second interval 
LOOP 
ARMLIGHT (1) 
WAIT (1) 
ARMLIGHT(@) 
WAIT (1) 
REPEAT 


Associated 
ARMBODY, ARMELBOW, ARMGRIPPER, ARMRESET, 


ARMSHOULDER, ARMWRIST 
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Functions, Constants & Procedures 


ARMRESET 


Purpose 
Reset the robot arm. 


Syntax 
ARMRESET 


Description 
Stops any moving motors on the robot arm and switches 
off the LED. 


Example 
ARMLIGHT (1) 
ARMELBOW(1) 
WAIT (2) 
ARMRESET 
END 


Associated 
ARMBODY, ARMELBOW, ARMGRIPPER, ARMLIGHT, 


ARMSHOULDER, ARMWRIST 
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ARMSHOULDER 


Purpose 
Move the robot arm shoulder. 


Syntax 
ARMSHOULDER (direction) 


Description 

Activates the motor in the shoulder of the robot arm 
according to the direction argument as follows: 

1 Move clockwise 

0 Stop 

-1 Move anti-clockwise. 


Example 

REM Move shoulder for 1s clockwise & back 
ARMSHOULDER(1) 

WAIT (1) 

ARMSHOULDER( -1) 

WAIT (1) 

ARMSHOULDER(@) 

END 


Associated 
ARMBODY, ARMELBOW, ARMGRIPPER, ARMLIGHT, 


ARMRESET, ARMWRIST 
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Functions, Constants & Procedures 


ARMWRIST 


Purpose 
Move the robot arm wrist. 


Syntax 
ARMWRIST (direction) 


Description 

Activates the motor in the wrist of the robot arm 
according to the direction argument as follows: 
1 Move clockwise 

0 Stop 

-1 Move anti-clockwise. 


Example 

REM Move wrist for 1s clockwise & back 
ARMWRIST(1) 

WAIT (1) 

ARMWRIST(-1) 

WAIT (1) 

ARMWRIST(@) 

END 


Associated 
ARMBODY, ARMELBOW, ARMGRIPPER, ARMLIGHT, 


ARMRESET, ARMSHOULDER 


ox main index 19 


ASC 


Purpose 
Return the ASCII code for a string character. 


Syntax 
asciticode=ASC(string$ ) 


Description 

Returns the ASCII value represented by the first character 
of stringS e.g. "A" would return 65. It is the opposite of 
the CHRS function. 


Example 

code=ASC("A") 

PRINT "ASCII value of letter A is: "3; code 
PRINT "ASCII char of code 65: "3; CHR$(code) 
END 


Associated 
CHRS 
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Functions, Constants & Procedures 


ASIN 


Purpose 
Returns the arc sine of the supplied argument. 


Syntax 
angle = ASIN(stne) 


Description 
This is the inverse of the SIN function returning the angle 
for a given sine. 


Example 

PRINT "Angle with sine = @.5: " 
DEG 

REM 30 Degrees 

PRINT "In Degrees: ";ASIN(@.5) 
RAD 

REM PI/6 Radians 

PRINT "In Radians: ";ASIN(@.5) 


CLOCK 

PRINT "In Minutes: ";ASIN(@.5) 
END 

Associated 


ACOS, ATAN, COS, SIN, TAN 
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ATAN 


Purpose 
Returns the arc tangent of the supplied argument. 


Syntax 
angLle=ATN(tangent) 


Description 
This is the inverse of the TAN function returning the angle 
for a given tangent. 


Example 

PRINT "Angle with tangent equal to 1: " 
DEG 

REM 45 Degrees 

PRINT "In Degrees: ";ATAN(1) 
RAD 

REM PI/4 Radians 

PRINT "In Radians: ";ATAN(1) 
CLOCK 

PRINT "In Minutes: ";ATAN(1) 
END 


Associated 
ACOS, ASIN, COS, SIN, TAN 
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Functions, Constants & Procedures 


BREAK 


Purpose 
Provide an early exit from a loop. 


Syntax 
BREAK 


Description 
Terminates a loop before the terminating condition is 
met. 


Example 
REM Loop until the space bar is pressed 
PRINT "Press the space bar to continue" 
LOOP 

IF INKEY=32 THEN BREAK 
REPEAT 
END 


Associated 
CONTINUE, LOOP, LOOP REPEAT, FOR REPEAT, REPEAT 


UNTIL, UNTIL REPEAT, WHILE REPEAT 
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CHR$ 


Purpose 
Returns the string character for the specified ASCII code. 


Syntax 
character$=CHR$(asciicode) 


Description 

Returns a one-character string consisting of the character 
corresponding to the ASCII code indicated by the asciicode 
argument. This is the opposite of the ASC function. 


Example 

PRINT "The following print the letter A" 
PRINT CHR$(65) 

PRINT CHR$(ASC("A")) 

PRINT "The following print the number 3" 
PRINT CHR$(51) 

PRINT CHR$(ASC("@") + 3) 

END 


Associated 
ASC 
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Functions, Constants & Procedures 


CIRCLE 


Purpose 
Draw a circle on the screen. 


Syntax 
CIRCLE(centrex,centrey,radius, fill) 


Description 

Draws a circle at position (centrex,centrey) with the 
specified radius in the current foreground COLOUR. The 
final parameter fill is either TRUE or FALSE, and specifies 
filled (TRUE) or outline (FALSE). 


Example 

CLS 

PRINT "Draw a filled yellow circle "; 
PRINT "In the centre of the screen" 
COLOUR=yellow 

CIRCLE (GWIDTH/2, GHEIGHT/2,10@, TRUE) 
UPDATE 

END 


Associated 
ELLIPSE, RECT, TRIANGLE 
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CLEARKEYBOARD CLOCK 


Purpose Purpose 

Clear all pending keyboard input. Set angle units to minutes. 
Syntax Syntax 

CLEARKEYBOARD CLOCK 

Description Description 


Clears the keyboard input buffer. 


Switches the internal angle system to clock mode. There 


are 60 minutes in a full circle. 


Example 
PRINT "Press space to continue" Example 
WHILE NOT SCANKEYBOARD(scanSpace) LOOP PRINT "ATAN(1) 
REPEAT DEG 
CLEARKEYBOARD PRINT ATAN(1); 
END CLOCK 
Associated aa PLANED: 
SCANKEYBOARD PRINT ATAN(1); 
END 
Associated 
DEG, RAD 


Degrees" 
Minutes" 


Radians" 
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CLONESPRITE 


Purpose 
Create a new sprite from an existing one. 


Syntax 
CLONESPRITE ( sprite handle ) 


Description 


Copies a sprite and its settings from an existing one 
(sprite handle) into a new one. 


Example 


sprite = newSprite (1) 
loadSprite (“ballBlue.png”, sprite, @) 
sprite2 = cloneSprite (sprite) 
LOOP 
PlotSprite (sprite, 100, 100, 0) 
PlotSprite (sprite2, 200, 200, 0) 
REPEAT 


Associated 
new$prite, loadSprite 
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Functions, Constants & Procedures 


CLOSE 


Purpose 
Close a file after use. 


Syntax 
CLOSE (handLe ) 


Description 

The CLOSE instruction closes the file specified by handle 
after use and makes sure all data is securely written to the 
storage medium. 


Example 

handle = OPEN("testfile.txt") 
PRINT# handle, "Colin" 

CLOSE (handle) 

handle = OPEN("testfile.txt") 
INPUT# handle, Name$ 

CLOSE (handle) 

PRINT "Name: " + Name$ 

END 


Associated 
EOF, FFWD, INPUT#, OPEN, PRINT#, REWIND, SEEK 
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CLS 


Purpose 
Clear screen. 


Syntax 
CLS 


Description 
Completely clear the screen of text and graphics. Note, this 
does not clear sprites from the screen. 


Example 

PRINT “Hello World” 
WAIT (1) 

CLS 

END 


Associated 
CLS, UPDATE 


Cx} 
mS 


Functions, Constants & Procedures 


CLS2 


Purpose 
Clear screen without an update. 


Syntax 
CLS2 


Description 

Ideally suited to games and graphical programming. CLS2 
clears the background or buffer screen and does not issue an 
update command. This means you can wipe the screen buffer, 
redraw on it and then issue an update. This ensures flicker free 
updates. It is also much faster than CLS. 


Example 


y = GHEIGHT / 2 

radius = GWIDTH / 10 

FOR x = @ TO GWIDTH STEP radius LOOP 
CES 


COLOUR = PINK 
CIRCLE (x, y, radius, 1) 
UPDATE 
REPEAT 
FOR x = GWIDTH TO @ STEP -1@ LOOP 
CLS2 
COLOUR = YELLOW 
CIRCLE (x, y, radius, 1) 
UPDATE 
REPEAT 


Associated 
CLS, UPDATE 
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COLOUR 


Purpose 
Set/Read the current graphics plot colour. 


Syntax 
COLOUR=setcolour 


Description 
Set/Read the current graphics plot colour as follows: 


0 Black 10 Pink 20 Teal 

1 DarkGrey 11 LightPink 21 Cyan 

2 Grey 12 DarkGreen 22 Aqua 

3 Silver 13 Green 23 LightBlue 
4 LightGrey 14 BrightGreen 24 Brown 

5 White 15 Olive 25 LightBrown 
6 Maroon 16 Lime 26 Orange 

7 Red 17 LightGreen 27 Gold 

8 Purple 18 Navy 28 Yellow 

9 Raspberry 19 Blue 29 LightYellow 
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Example 
CLS 
FOR c=@ TO 29 LOOP 
COLOUR=c 
CIRCLE(5@, GHEIGHT-c*4@-50, 20, TRUE ) 
COLOUR=WHITE 
CIRCLE(5@, GHEIGHT -c*4@-5@, 20, FALSE) 
READ NameOfColour$ 
HVTAB(5,c*2+2) 
PRINT NameOfColour$;" "5c 
REPEAT 
UPDATE 
DATA "Black", "DarkGrey", "Grey", "Silver" 
DATA "LightGrey", "White", "Maroon", "Red" 
DATA "Purple", "Raspberry", "Pink", "LightPink" 
DATA "DarkGreen", "Green", "BrightGreen", "Olive" 
DATA "Lime", "LightGreen", "Navy", "Blue", "Teal" 
DATA "Cyan", "Aqua", "LightBlue", "Brown" 
DATA “LightBrown", "Orange", "Gold", "Yellow" 
DATA "LightYellow" 
END 


Associated 
INK, PAPER, RGBCOLOUR 
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COPYREGION 


Purpose 
Copy a region of the screen from one location to another. 


Syntax 
COPYREGION(oldx,oldy,width, height ,newX,newY) 


Description 

This enables you to duplicate the contents of a section of 
the screen from one place to another. This could be used 
for example to create a background for a game by 
drawing an image and then duplicating it. The region to be 
copied is specified by the rectangle at coordinates 
(oldx,oldy) width pixels wide and height pixels 

high. The region is copied to coordinates (newx,newy) 
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Example 

REM Draws a Brick Wall 

COLOUR=RED 

RECT(@,0,50,50@, TRUE) 

COLOUR=WHITE 

LINE(@,50,50,50) 

LINE(@, 25,50, 25) 

LINE(@,25,0,50) 

LINE(50,25,50,50) 

LINE(25,0,25,25) 

LINE(0,0,50,0) 

FOR X=@ TO GWIDTH STEP 5@ LOOP 
FOR Y=@ TO GHEIGHT STEP 5@ LOOP 

COPYREGION(@,0,50,50,X,Y) 

REPEAT 

REPEAT 

UPDATE 

END 


Associated 
GRABREGION 
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COS 


Purpose 
Returns the cosine of the given angle. 


Syntax 
cosine=COS(angLe) 


Description 

Returns the cosine of the argument angle. This is the ratio 
of the side of a right angled triangle, that is adjacent to 
the angle, to the hypotenuse (the longest side). 


Example 

CLS 

PRINT "Draw ellipse in screen centre" 

DEG 

FOR Angle=@ TO 36@ LOOP 
Xpos=100*COS(Angle)+GWIDTH / 2 
Ypos=50*SIN(Angle)+GHEIGHT / 2 
PLOT(Xpos, Ypos) 

REPEAT 

END 


Associated 
ACOS, ASIN, ATAN, SIN, TAN 
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LOOP 


Purpose 
Defines the start of a block of code to be repeated. 


Syntax 
LOOP 


Description 

Marks the start of a block of repeating code (called a 
loop). The number of times that the loop is executed 
depends on the command used before LOOP or at the 
end of the loop. 


Example 
REM See Associated commands below. 


Associated 
BREAK, CONTINUE, LOOP REPEAT, FOR REPEAT, REPEAT 


UNTIL, UNTIL REPEAT, WHILE REPEAT 
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LOOP REPEAT 


Purpose 
Create an infinite loop. 


Syntax 

LOOP 
{statements} 

REPEAT 


Description 

Execute the statements again and again forever. 

The BREAK command can be used to terminate the loop 
or control can be explicitly transferred to somewhere 
outside of the loop by commands like GOTO (not 
recommended). 

Pressing the Esc key will also interrupt the loop (and 
program). 


Example 
REM Loop until the space bar is pressed 
PRINT "Press the space bar to continue" 
LOOP 

IF INKEY = 32 THEN BREAK 
REPEAT 
END 


Associated 
BREAK, CONTINUE, LOOP, FOR REPEAT, REPEAT UNTIL, 


UNTIL REPEAT, WHILE REPEAT 


Cx} 
me OS 


Functions, Constants & Procedures 


DATA 


Purpose 
Store constant data. 


Syntax 
DATA constant{,constant} 


Description 
Stores numerical and string constants for later retrieval 
using the READ command. 


Example 
REM Load the name of the days of the 
REM week into a string array 
DATA "Monday", "Tuesday", "Wednesday" 
DATA "Thursday", "Friday", "Saturday" 
DATA "Sunday" 
DIM DaysOfWeek$(7) 
FOR DayNo=1 TO 7 LOOP 
READ DaysOfWeek$(DayNo) 
REPEAT 
FOR DayNo=1 TO 7 LOOP 
PRINT "Day of the week number ";DayNo; 
PRINT " is ";DaysOfWeek$(DayNo) 
REPEAT 
END 


Associated 
READ, RESTORE 
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DATE$ 


Purpose 
Return the current date. 


Syntax 
todaysdate$ = DATE$ 


Description 


This returns a string with the current date in the format: 


YYYY-MM-DD. For example: 2015-03-24. 


Example 
PRINT "Today is ";FN FormatDate(DATE$) 
END 


Cx} 
mS 


Functions, Constants & Procedures 


DEF FN FormatDate() 
DayNo=VAL(RIGHT$(DATE$, 2)) 
MonthNo=VAL (MID$(DATE$, 5, 2)) 
Year$=LEFT$(DATE$,4) 

SWITCH (DayNo MOD 10) 
CASE 1 
DaySuf fix$ 
ENDCASE 
CASE 2 
DaySuf fix$ 
ENDCASE 
CASE 3 
DaySuf fix$ 
ENDCASE 
DEFAULT 
DaySuf fix$ 
ENDCASE 
ENDSWITCH 
FOR I=1 TO MonthNo LOOP 
READ MonthName$ 
REPEAT 
Result$=STR$(DayNo)+DaySuffix$+" " 
=Result$+MonthName$+" "+Year$ 

DATA "January", "February", "March", "April" 

DATA "May", "June", "July", "August" 

DATA "September", "October", "November" 

DATA "December" 


"St " 


"nd" 


"nd" 


"th" 


Associated 
TIMES 
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DEF FN 


Purpose 
Create a user defined function. 


Syntax 

DEF FN name({parameter}{,parameter}) 
{commands } 

=vaLue 


Description 

User defined functions are similar to user defined 
procedures except that they can return a value. This can 
be either a number or a character string. 


Example 
REM Function test - print squares 
FOR I=1 TO 10 LOOP 
x=FN square(I) 
PRINT I; " squared is "3; x 
REPEAT 
END 
DEF FN square(num) 
LOCAL result 
result=num*num 
=result 


Associated 
FN, LOCAL 
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DEF PROC 


Purpose 
Create a user defined procedure. 


Syntax 

DEF PROC name({parameter}{,parameter}) 
{commands } 

ENDPROC 


Description 

Allows you to create your own routines that can be called by 
their label. Once you have written a procedure to do a ; 
particular task you can copy it into other proprame that require 
it. Procedures are usually defined after the END of the 
program. 


Example 
CLS 
PROC Hexagon(2@@, 200, 100,Red) 
UPDATE 
END 
DEF PROC Hexagon(x,y,1,c) 
PENUP 
MOVETO(x-1*C0S(3@), y+1/2) 
COLOUR = c 
PENDOWN 
FOR I=1 to 6 LOOP 
RIGHT (60) 
MOVE (1) 
REPEAT 
ENDPROC 


Associated 
LOCAL, PROC 
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DEFCHAR 


Purpose 
Define a new font character. 


Syntax 
DEFCHAR(char, Line1 ... Line1@) 


Description 

Create a user defined font character. The char parameter 
is the position of the character within the font (0-255) e.g. 
65 is the capital letter A in ASCII. The character consists of 
10 lines with 8 pixels in each line. These are set by the 
corresponding bits in each of the /ine parameters. So for 
example decimal 170 (binary 10101010) would set 


alternate pixels on the corresponding line of the character. 


Example 

REM Define Chessboard Character 
FONTSIZE(10) 
DEFCHAR(2,0,85,170,85,170,85,170, 85,170,060) 
PRINT CHR$(2) 

END 


Associated 
CHRS 
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DEG 


Purpose 
Set angle units to degrees. 


Syntax 
DEG 


Description 
Switches the internal angle system to degree mode. There 
are 360 degrees in a full circle. 


Example 

REM Draw an ellipse in the screen centre 

CLS 

DEG 

FOR Angle = @ TO 360 LOOP 
Xpos=100*COS(Angle)+GWIDTH / 2 
Ypos=50*SIN(Angle)+GHEIGHT / 2 
PLOT(Xpos, Ypos) 

REPEAT 

END 


Associated 
CLOCK, RAD 
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DIGITALREAD 


Purpose 
Read the state of a digital pin on the Raspberry Pi. 


Syntax 
pinvaLue=DIGITALREAD(pinno) 


Description 

Reads the state of a digital pin on the Raspberry Pi. You 

may need to set the pin mode beforehand to make sure 
it’s configured as an input device. It will return TRUE or 


FALSE to indicate an input being high or low respectively. 


Example 

REM Set pin 12 to input 

PINMODE (12,0) 

REM Wait for button to be pushed 
UNTIL DIGITALREAD(12) LOOP 
REPEAT 

PRINT "Button Pushed" 

END 


Associated 
DIGITALWRITE, PINMODE, PWMWRITE 
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DIGITALWRITE 


Purpose 
Set the state of a digital pin on the Raspberry Pi. 


Syntax 
DIGITALWRITE (pinno, pinvaLue) 


Description 

This procedure sets a digital pin to the supplied value - 0 
for off or 1 for on. As with DigitalRead, you may need to 
set the pin mode (to output) beforehand. 


Example 
REM Flash LED attached to pin2 of GPIO 
REM Set pin 2 to output mode 
PINMODE(2,1) 
LOOP 
REM Set output High (on) 
DIGITALWRITE(2,1) 
WAIT(1) 
REM Set output Low (off) 
DIGITALWRITE(2, 0) 
WAIT(1) 
REPEAT 
END 


Associated 
DIGITALREAD, PINMODE, PWMWRITE 
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DIM 


Purpose 
Dimension an array of variables. 


Syntax 
DIM vartabLle(dimension{ ,dimension}) 


Description 


Creates an indexed variable with one or more dimensions. 


The variable can be either a numeric or character string 
type (they cannot hold mixed values). The index is a 
number from 0 to the size of the dimension. 

Associative arrays (sometimes called maps) are another 
way to refer to the individual elements of an array. In the 
example below we use a number, however strings are 
also allowed. They can be multi-dimensional and you can 
freely mix numbers and strings for the array indices. 
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Example 
REM Initialise the squares of a chess 
REM board to black or white 
DIM ChessBoard(8,8) 
Count=@ 
FOR Row=1 TO 8 LOOP 
FOR Col=1 TO 8 LOOP 
Count=Count+1 
IF Count MOD 2=1 THEN 


ChessBoard(Row,Col) = Black 
ELSE 
ChessBoard(Row,Col) = White 
ENDIF 
REPEAT 
REPEAT 
PRINT ChessBoard(1,4) 
END 
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DRCANALOGREAD 


Purpose 
Read an analog channel on a DRC device. 


Syntax 
vol tage=DRCANALOGREAD (handLe, pin) 


Description 

This function reads an analog channel ona DRC 
compatible device specified by handle and returns the 
result. The value returned will depend on the hardware 
you’re connected to - for example the Arduino will return 
a number from 0 to 1023 representing an input voltage 
between 0 and 5 volts. Other devices may have different 
ranges. 


Example 

arduino=DRCOPEN("/dev/ttyUSB@" ) 

REM Get voltage on pin 4 
voltage=DRCANALOGREAD(arduino, 4)/1023*5 
PRINT "Voltage= "; voltage 
DRCCLOSE(arduino) 

END 


Associated 
DRCCLOSE, DRCDIGITALREAD, DRCDIGITALWRITE, 


DRCOPEN, DRCPINMODE, DRCPWMWRITE 
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DRCCLOSE 


Purpose 
Close a connection to a DRC compatible device. 


Syntax 
DRCCLOSE (handle) 


Description 

This closes a connection to a DRC device and frees up any 
resources used by it. It’s not strictly necessary to do this 
when you end your program, but it is considered good 
practice. 


Example 

arduino = DRCOPEN("/dev/ttyUSBe" ) 

REM Set pin 12 to input 
DRCPINMODE(arduino, 12, 0) 

LOOP 

REPEAT UNTIL DRCDIGITALREAD(arduino, 12) 
PRINT "Button Pushed" 

DRCCLOSE(arduino) 

END 


Associated 
DRCANALOGREAD, DRCDIGITALREAD, DRCDIGITALWRITE, 


DRCOPEN, DRCPINMODE, DRCPWMWRITE 
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DRCDIGITALREAD 


Purpose 
Read the state of a digital pin on a remote DRC device. 


Syntax 
state=DRCDIGITALREAD(handLe, pin) 


Description 

This function allows you to read the state of a digital pin 
ona DRC device specified by handle. You may need to set 
the pin mode beforehand to make sure it’s configured as 
an input device. It will return TRUE or FALSE to indicate an 
input being high or low respectively. 


Example 

arduino = DRCOPEN("/dev/ttyUSBe" ) 

REM Set pin 12 to input 
DRCPINMODE(arduino, 12, @) 

LOOP 

REPEAT UNTIL DRCDIGITALREAD(arduino, 12) 
PRINT "Button Pushed" 

DRCCLOSE(arduino) 

END 


Associated 
DRCANALOGREAD, DRCCLOSE, DRCDIGITALWRITE, 


DRCOPEN, DRCPINMODE, DRCPWMWRITE 
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DRCDIGITALWRITE 


Purpose 
Set a digital pin on a remote DRC device to the supplied 
value. 


Syntax 
DRCDIGITALWRITE (handLe, pin, vaLue) 


Description 

This procedure sets a digital pin on a DRC device specified 
by handle to the supplied value - 0 for off or 1 for on. As 
with DrcDigitalRead, you may need to set the pin mode 
beforehand. 


Example 
arduino=DRCOPEN("/dev/ttyUSB@" ) 
REM Set pin 2 to output mode 
DRCPINMODE(arduino, 2, 1) 

REM Set Output High (on) 
DRCDIGITALWRITE(arduino, 2, 1) 
REM Pause for 1 second 

WAIT(1) 

REM Set output Low (off) 
DRCDIGITALWRITE(arduino, 2, 0) 
DRCCLOSE(arduino) 

END 


Associated 
DRCANALOGREAD, DRCCLOSE, DRCDIGITALREAD, 


DRCOPEN, DRCPINMODE, DRCPWMWRITE 
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DRCOPEN 


Purpose 
Open a connection to a DRC compatible device. 


Syntax 
handLe=DRCOPEN(drcdevice) 


Description 

This opens a connection to a DRC compatible device and 
makes it available for our use. It takes the name of the 
device as an argument and returns a number (the handle) 
of the device. We can use this handle to reference the 
device and allow us to open several devices at once. Some 
implementations may have IO devices with fixed names. 


Example 

arduino = DRCOPEN("/dev/ttyUSBe" ) 

REM Set pin 12 to input 
DRCPINMODE(arduino, 12, 0) 

LOOP 

REPEAT UNTIL DRCDIGITALREAD(arduino, 12) 
PRINT "Button Pushed" 

DRCCLOSE(arduino) 

END 


Associated 
DRCANALOGREAD, DRCCLOSE, DRCDIGITALREAD, 


DRCDIGITALWRITE, DRCPINMODE, DRCPWMWRITE 
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DRCPINMODE 


Purpose 
Configure the mode of a pin on a remote DRC device. 


Syntax 
DRCPINMODE (handLe, pin,mode) 


Description 


This configures the mode of a pin on the DRC device specified 
by handle. It takes an argument which specifies the mode of 

the specified pin - input, output or PWM output. Other modes 
may be available, depending on the device and its capabilities. 
Note that not all devices support all functions. The modes are: 


0 pinINPUT 
1 pinOUTPUT 
2 pinPWM 


Example 

arduino = DRCOPEN("/dev/ttyUSBe" ) 

REM Set pin 12 to input 
DRCPINMODE(arduino, 12, 0) 

LOOP 

REPEAT UNTIL DRCDIGITALREAD(arduino, 12) 
PRINT "Button Pushed" 

DRCCLOSE(arduino) 

END 


Associated 
DRCANALOGREAD, DRCCLOSE, DRCDIGITALREAD, 


DRCDIGITALWRITE, DRCOPEN, DRCPWMWRITE 
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DRCPWMWRITE 


Purpose 
Output a PWM waveform on the selected pin of a DRC 
device. 


Syntax 
DRCPWMWRITE (handLe, pin, vaLue) 


Description 

This procedure outputs a PWM waveform on the specified 
pin of a DRC compatible device specified by handle. The 
pin must be configured for PWM mode beforehand, and 
depending on the device you are using, then not all pins 
on a device may support PWM mode. The value set 
should be between 0 and 255. 


Example 
arduino=DRCOPEN("/dev/ttyUSB@" ) 
REM Set pin 11 to PWM output mode 
DRCPINMODE(arduino, 11, 2) 
DRCPWMWRITE(arduino, 11, 200) 
DRCCLOSE(arduino) 

END 


Associated 
DRCANALOGREAD, DRCCLOSE, DRCDIGITALREAD, 


DRCDIGITALWRITE, DRCOPEN, DRCPINMODE 
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ELLIPSE 


Purpose 
Draw an ellipse on the screen. 


Syntax 
ELLIPSE(xpos,ypos, xradius, yradius, fill) 


Description 

Draws an ellipse centred at position (xpos,ypos) with the 
specified xradius and yradius in the current foreground 
COLOUR. The final parameter fil/ is either TRUE or FALSE, 
and specifies filled (TRUE) or outline (FALSE). 


Example 

CLS 

REM Draw a filled red ellipse at 
REM location 200,200 

COLOUR=red 

ELLIPSE (200, 200,100,50, TRUE) 
UPDATE 

END 


Associated 
CIRCLE, RECT, TRIANGLE 
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ELSE 


Purpose 


Execute statement(s) when a tested condition is False. 


Syntax 

IF condition THEN 
{statements} 

ELSE 

{statements} 
ENDIF 

Example 

Number = 13 


IF Number MOD 2 = © THEN 
PRINT "Number is Even" 
ELSE 
PRINT "Number is Odd" 
ENDIF 
END 


Associated 
ENDIF, IF THEN 
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END 


Purpose 
End program execution. 


Syntax 
END 


Description 
Program execution is ended. Programs must terminate 
with the END or STOP commands or an error will occur. 


Example 
PRINT "Hello World" 
END 
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ENDIF 


Purpose 
Terminate a multiline conditional statement. 


Syntax 

IF condition THEN 
{statements} 
ENDIF 


Description 

We can extend the IF statement over multiple lines, if 
required. The way you do this is by making sure there is 
nothing after the THEN statement and ending it all with 
the ENDIF statement. 


Example 

DayOfWeek = 5 

IF DayOfWeek < 6 THEN 
PRINT "It is a Weekday" 
PRINT "Go to Work!" 

ENDIF 

END 


Associated 
ELSE, IF THEN 
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ENDPROC 


Purpose 
Defines the end of a PROCedure 


Syntax 
ENDPROC 


Description 
End a PROCedure and return to the next command after 
the procedure was called. 


Example 

CLS 

PROC hello 

END 

DEF PROC hello 

PRINTAT (10,10); "Hello" 
ENDPROC 


Associated 
PROC 
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ENVELOPE 


Purpose 
Emulate the BBC BASIC sound envelope command. 


Syntax 
ENVELOPE(N,7,PI1,P12,PI3,PN1,PN2,PN3,AA,AD, 
AS ,AR,ALA,ALD) 


Description 

NOTE: This is an experimental function. It might not 
perform entirely as expected. It is also prone to crashing 
if incorrect values are used. Use with caution! 
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N 1 to 8 Envelope number. 


T Oto 127 Length of each step in hundredths of a second. 
Add 128 to cancel auto repeat of the pitch envelope. 


Pl1 -128 to 127 Pitch change per step in section 3 
Pl2 -128 to 127 Change of pitch per step in section 2 
PI3 -128 to 127 Change of pitch per step in section 1 
PN1 0 to 255 Number of steps in section 1 

PN2 0 to 255 Number of steps in section 2 

PN3 0 to 255 Number of steps in section 3 

AA -127 to 127 Change of attack amplitude per step 
AD -127 to 127 Change of decay amplitude per step 
AS -127 to 0 Change of sustain amplitude per step 
AR -127 to O Change of release amplitude per step 
ALA 0 to 126 Level at end of the attack phase 

ALD 0 to 126 Level at end of the decay phase 


Example 

ENVELOPE (1, 2, - 
2,10,1,80,40,40,127,0,0,0,126,126) 
SOUND(1, 1, 53, 64) 

END 


Associated 
SOUND 
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EOF 


Purpose 
Return true if the end of an input file has been reached. 


Syntax 
endoffile=EOF (handle) 


Description 

The EOF function returns a TRUE or FALSE indication of 
the state of the file pointer when reading the file. It is an 
error to try to read past the end of the file, so if you are 
reading a file with unknown data in it, then you must 


check at well defined intervals (e.g. Before each INPUT#). 


Example 
handle=OPEN("eoftest.txt") 
FOR r = ® TO 10 LOOP 
PRINT# handle, "Record "; r 
REPEAT 
CLOSE (handle) 
handle = OPEN("eoftest.txt") 
WHILE NOT EOF (handle) LOOP 
INPUT# handle, record$ 
PRINT record$ 
REPEAT 
CLOSE (handle) 
END 


Associated 
CLOSE, FFWD, INPUT#, OPEN, PRINT#, REWIND, SEEK 
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EXP 


Purpose 
Return the exponential value of the specified number. 


Syntax 
exponenttaL=EXP (number) 


Description 

Returns the exponential value of the specified number. 
This is e to the power of number where e is the 
exponential constant (approximately 2.718281828). The 
exponential function arises whenever a quantity grows or 
decays at a rate proportional to its current value. This is 
the opposite of the LOG function i.e. EXP(LOG(X)) = X 


Example 

REM prints 2.718281828 
PRINT EXP(1) 

REM prints 22026.46579 
PRINT EXP(10) 

REM prints 10 

PRINT LOG(EXP(1@) ) 

END 


Associated 
LOG 
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FADEOFF FADEON 


Purpose Purpose 

Fade the display from light to dark Fade the display from dark to light 

Syntax Syntax 

FADEOFF FADEON 

Description Description 

FADEOFF initiates a fade from light to dark. The entire FADEON initiates a fade from dark to light. The entire 

screen display is affected. screen display is affected. 

Example Example 

PAPER=@ PAPER=@ 

INK=1 INK=1 

CLS CLS 

PRINT “LOADING...” PRINT “LOADING...” 

FADEOFF FADEOFF 

WHILE FADING = true LOOP WHILE FADING = true LOOOP 
UPDATE UPDATE 

REPEAT REPEAT 

FADEON FADEON 

WHILE FADING = true LOOP WHILE FADING = true LOOP 
UPDATE UPDATE 

REPEAT REPEAT 

END END 

Associated Associated 

FADEON, FADING FADEOFF, FADING 
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FADING 


Purpose 
Check if the display is fading 


Syntax 
FADING 


Description 


Returns either TRUE (if fade in progress) or FALSE (no 
fade active) 


Example 

PAPER=0 

INK=1 

CLS 

PRINT "LOADING..." 

FADEOFF 

WHILE FADING = true LOOP 
UPDATE 

REPEAT 

FADEON 

WHILE FADING = true LOOP 
UPDATE 

REPEAT 

END 


Associated 
FADEON, FADING 


Cx} 
me OS 


Functions, Constants & Procedures 


FALSE 


Purpose 
Represent the logical "false" value. 


Syntax 
FALSE 


Description 


Represents a Boolean value that fails a conditional test. It 


is equivalent to a numeric value of 0. 


Example 
condition = FALSE 
IF condition = FALSE THEN 
PRINT "Condition is FALSE" 
ENDIF 
IF NOT condition THEN 
PRINT "Condition is FALSE" 
ENDIF 
PRINT "Condition= ";condition 
END 


Associated 
TRUE 
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FFWD 


Purpose 
Move the file pointer to the end of a file. 


Syntax 
FFWD(handLe) 


Description 

Move the file pointer back to the end of the file specified 
by handle. If you want to append data to the end of an 
existing file, then you need to call FFWD before writing 
the data. 


Example 
handle=OPEN("ffwdtest.txt") 
PRINT# handle, "First Line" 
CLOSE (handle) 
handle = OPEN ("ffwdtest.txt") 
FFWD (handle) 
PRINT# handle, "“Appended line" 
CLOSE (handle) 
handle = OPEN("ffwdtest.txt") 
WHILE NOT EOF (handle) LOOP 
INPUT# handle, record$ 
PRINT record$ 
REPEAT 
CLOSE (handle) 
END 


Associated 
CLOSE, EOF, INPUT#, OPEN, PRINT#, REWIND, SEEK 
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FN 


Purpose 
Call a user defined function. 


Syntax 
resuLt=FN name({argument}{,argument}) 


Description 

Calls the specified user defined function called name with 
the specfied arguments. The returned result can then be 
used by the program. Once the function has been 
executed control returns to the command following. 


Example 

PRINT FN SphereVolume(10) 

END 

REM Function calculate volume of a sphere 
REM with radius r 

DEF FN SphereVolume(r) 

= (4/3)*PI*r*r*r 


Associated 
DEF FN 
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FONTSIZE 


Purpose 
Scale the text font. 


Syntax 
FONTSIZE(scaLe) 


Description 


Change the size of the text font. 


Example 
FOR S=1 TO 10 LOOP 
FONTSIZE(S) 
PRINT "Hello World" 
REPEAT 
END 


Associated 
PRINTAT, LOADFONT 


Cx} 
mS 


Functions, Constants & Procedures 


FOR LOOP 


Purpose 
Loop a specified number of times using a counter. 


Syntax 

FOR count=start TO end [STEP step] LOOP 
statements 

REPEAT 


Description 


The count variable is initially set to start and changes by step 
each time around the loop until count is greater than or equal 
to end. The optional step, which defaults to 1 may be less 
than zero to count backwards. The end of the loop is indicated 
using the REPEAT. 


Example 
REM year into a string array 
DATA "January", "February", "March" 
DATA "April", "May", "June" 
DATA "July", "August", "September" 
DATA "October", "November", "December" 
DIM Months$(12) 
FOR Month = 1 TO 12 LOOP 

READ Months$(Month) 
REPEAT 
PRINT "The seventh month is ";Months$(7) 
END 


Associated 
BREAK, CONTINUE, LOOP, LOOP REPEAT, REPEAT UNTIL, 


UNTIL REPEAT, WHILE REPEAT 
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FREEIMAGE 


Purpose 
Release an image from memory 


Syntax 
FREEIMAGE(handLe) 


Description 
Frees up the memory space taken up by a stored image 


Example 

handle = LOADIMAGE( "sprite1.bmp" ) 
PLOTIMAGE( handle, @, @ ) 

UPDATE 

FREEIMAGE( handle ) 

handle = LOADIMAGE( "sprite2.bmp" ) 
PLOTIMAGE( handle, 100, 1002 ) 
UPDATE 

END 


Associated 
LOADIMAGE, PLOTIMAGE 
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Functions, Constants & Procedures 


FULLSCREEN 


Purpose 
Sets the display to full screen mode. 


Syntax 
FULLSCREEN={ TRUE/FALSE } 


Description 

Switches between full screen or windowed mode. Note 
this does not set the resolution to the screen display 
mode so unless you set the mode manually you will get a 
border. 


Example 

SETMODE (800, 602) 
FULLSCREEN=0 

COLOUR=RED 

RECT(@,@,GWIDTH, GHEIGHT,@) 
UPDATE 

WAIT (2) 

FULLSCREEN=1 

WAIT (2) 

END 


Associated 
SETMODE 
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GET 


Purpose 
Get a single character code from the keyboard. 


Syntax 
ascitcode=GET 


Description 

This pauses program execution and waits for you to type a 
single character on the keyboard, then returns the value 
of the key pressed as a numeric variable (ASCII). 


Example 

PRINT "Press a key" 

key = GET 

PRINT "ASCII Value of key = "; key 
END 


Associated 
GETS, INKEY 
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Functions, Constants & Procedures 


GET$ 


Purpose 
Get a single character from the keyboard. 


Syntax 
key$ = GET$ 


Description 

This pauses program execution and waits for you to type a 
single character on the keyboard, then returns the key as 
a string variable. 


Example 

PRINT "Press a key" 

key$ = GET$ 

PRINT "You Pressed Key: "; key$ 
END 

Associated 

GET, INKEY 
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GETIMAGEH 


Purpose 
Get the pixel height of a loaded image. 


Syntax 
GETIMAGEH(handLe) 


Description 
Gets the height in pixels of a loaded image 


Example 

REM Centre image on screen 

logo=LOADIMAGE ("/usr/share/fuze/logo.bmp" ) 
imageW=GET IMAGEW( logo) 

imageH=GET IMAGEH( logo) 

X=(GWIDTH- imageW) /2 

Y=(GHEIGHT - imageH) /2 

PLOTIMAGE (logo, X, Y) 

UPDATE 

END 


Associated 
GETIMAGEW, LOADIMAGE, PLOTIMAGE 
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Functions, Constants & Procedures 


GETIMAGEW 


Purpose 
Get the pixel width of a loaded image. 


Syntax 
GETIMAGEW(handLe) 


Description 

Gets the width in pixels of an image previously loaded 
using LOADIMAGE (using the handle returned by 
LOADIMAGE). 


Example 

REM Centre image on screen 

logo=LOADIMAGE ("/usr/share/fuze/logo.bmp" ) 
imageW=GETIMAGEW( logo) 
imageH=GETIMAGEH( logo) 

X=(GWIDTH-imageW) /2 

Y=(GHEIGHT -imageH) /2 

PLOTIMAGE (logo, X,Y) 

UPDATE 

END 


Associated 
GETIMAGEH, LOADIMAGE, PLOTIMAGE 
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GETMOUSE 


Purpose 
Read values from an attached mouse 


Syntax 
GETMOUSE (xpos, ypos, buttons) 


Description 
This reads values for the current state of the mouse. xpos is the 


horizontal mouse position, ypos is the vertical position and 
buttons is the state of the mouse buttons. You can test 
whether the left button has been pressed by using the logical & 
operator to see if bit 0 of the buttons value is set: buttons & 1 
will be TRUE. Likewise if the right button is pressed then bit 3 
will be set and buttons & 4 will be TRUE. 


Example 
CLS 
MOUSEON 
LOOP 
GETMOUSE(x,y,b) 
LINETO(x,y) 
UPDATE 
REM LOOP colour if left button pressed 
IF b & 1 THEN 
COLOUR = COLOUR MOD 16 + 1 
ENDIF 
REM Exit if right button pressed 
REPEAT UNTIL b & 4 
MOUSEOFF 
END 


Associated 
MOUSEOFF, MOUSEON, MOUSEX, MOUSEY, SETMOUSE 


Cx) 
mm OS 


Functions, Constants & Procedures 


GETPIXEL 


Purpose 
Return the colour of the specified pixel. 


Syntax 
colour = GETPIXEL(xpos, ypos) 


Description 

This returns the internal colour code (0-15) of the pixel at 
the specified point (xpos,ypos). This is for the "named" 
colours - e.g. Red, Green etc. It returns -1 if the pixel 
colour is not a standard colour - in which case, you need 
to use GETPIXELRGB. 


Example 

CLS 

COLOUR = RED 

Xpos = GWIDTH / 2 

Ypos = GHEIGHT / 2 
PLOT(Xpos, Ypos) 

PRINT GETPIXEL(Xpos, Ypos) 
END 


Associated 
GETPIXELRGB 
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GETPIXELRGB GETSPRITEANGLE 


Purpose Purpose 

Return the RGB colour of the specified pixel. Returns a sprite’s current angle 

Syntax Syntax 

RGBcoLour = GETPIXELRGB( xpos, ypos) GETSPRITEANGLE(spriteIndex) 
Description Description 

This returns the RGB colour of the pixel at the specified point Returns the angle of the sprite with the specified 
(xpos, ypos). This will return a 24-bit value. spritelndex. 

Example Example 

CLS sprite = newSprite (1) 

RGBCOLOUR(49, 101, 206) loadSprite ("logo.png", sprite, @) 
Xpos = GWIDTH / 2 angle = @ 

Ypos = GHEIGHT / 2 plotSprite (sprite, gWidth / 2, gHeight / 2, @) 
CIRCLE(Xpos, Ypos, 5@, TRUE) LOOP 

pixel = GETPIXELRGB(Xpos, Ypos) cls2 

PRINT "RGB = "3; pixel setSpriteAngle (sprite, angle) 
PRINT "Red = "; (pixel >> 16) & @xFF angle = angle + 1 

PRINT "Green = "; (pixel >> 8) & OxFF if angle>359 THEN angle=@ 

PRINT "Blue = "; (pixel >> @) & @xFF printat(0,@);getspriteangle(sprite) 
END UPDATE 

Associated REREMT 

GETPIXEL Associated 


GETSPRITEW, HIDESPRITE, LOADSPRITE, NEWSPRITE, 
PLOTSPRITE, SETSPRITETRANS, SPRITECOLLIDE, 
SPRITECOLLIDEPP 
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GETSPRITEH 


Purpose 
Get the pixel height of a sprite. 


Syntax 
GETSPRITEH(spriteIndex) 


Description 
Returns the height in pixels of the sprite with the specified 
spritelndex. 


Example 

REM Centre sprite on the screen 
index=NEWSPRITE(1) 
fuzelogo$="/usr/share/fuze/logo. bmp" 
LOADSPRITE (fuzelogo$, index, @) 
spriteW=GETSPRITEW( index ) 
spriteH=GETSPRITEH(index) 
X=(GWIDTH- spriteW) /2 
Y=(GHEIGHT-spriteH)/2 
PLOTSPRITE(index,X,Y,®) 

UPDATE 

END 


Associated 

GETSPRITEW, HIDESPRITE, LOADSPRITE, NEWSPRITE, 
PLOTSPRITE, SETSPRITETRANS, SPRITECOLLIDE, 
SPRITECOLLIDEPP 
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Functions, Constants & Procedures 


GETSPRITEW 


Purpose 
Get the pixel width of a sprite. 


Syntax 
GETSPRITEW(spriteIndex) 


Description 
Returns the width in pixels of the sprite with the specified 
spritelndex. 


Example 

REM Centre sprite on the screen 
index=NEWSPRITE(1) 
fuzelogo$="/usr/share/fuze/ logo. bmp" 
LOADSPRITE(fuzelogo$, index, @) 
spriteW=GETSPRITEW( index ) 
spriteH=GETSPRITEH( index ) 
X=(GWIDTH-spriteW) /2 
Y=(GHEIGHT-spriteH) /2 
PLOTSPRITE(index,X,Y,) 

UPDATE 

END 


Associated 

GETSPRITEH, HIDESPRITE, LOADSPRITE, NEWSPRITE, 
PLOTSPRITE, SETSPRITETRANS, SPRITECOLLIDE, 
SPRITECOLLIDEPP 
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GETSPRITEX 


Purpose 
Get the X position of a sprite. 


Syntax 
GETSPRITEX(spriteIndex) 


Description 


Returns the X position in pixels of the sprite with the 
specified sprite/ndex. 


Example 

updateMode = @ 

sprite = newSprite (1) 

loadSprite ("logo.png", sprite, @) 

LOOP 
CLS2 
plotSprite (sprite, gwidth / 2, gHeight / 2, @) 
PRINT getSpriteX (sprite) 
PRINT getSpriteY (sprite) 
UPDATE 

REPEAT 


Associated 
GETSPRITEW, HIDESPRITE, LOADSPRITE, NEWSPRITE, 


PLOTSPRITE, SETSPRITETRANS, SPRITECOLLIDE, 
SPRITECOLLIDEPP 
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Functions, Constants & Procedures 


GETSPRITEY 


Purpose 
Get the Y position of a sprite. 


Syntax 
GETSPRITEY(spriteIndex) 


Description 


Returns the Y position in pixels of the sprite with the 
specified sprite/ndex. 


Example 

updateMode = @ 

sprite = newSprite (1) 

loadSprite ("logo.png", sprite, @) 

LOOP 
CLS2 
plotSprite (sprite, gwidth / 2, gHeight / 2, @) 
PRINT getSpriteX (sprite) 
PRINT getSpriteY (sprite) 
UPDATE 

REPEAT 


Associated 
GETSPRITEH, HIDESPRITE, LOADSPRITE, NEWSPRITE, 


PLOTSPRITE, SETSPRITETRANS, SPRITECOLLIDE, 
SPRITECOLLIDEPP 


OR 
oy F 
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GHEIGHT 


Purpose 
Find the current height of the display. 


Syntax 
height=GHEIGHT 


Description 
This can be read to find the current height of the display 
in either high resolution or low resolution pixels. 


Example 

REM Draw a circle in the centre of the 
screen 

CLS 

COLOUR = blue 
CIRCLE(GWIDTH/2,GHEIGHT/2,5@, TRUE) 
UPDATE 

END 


Associated 
GWIDTH, ORIGIN, SETMODE 
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Functions, Constants & Procedures 


GRABREGION 


Purpose 
Grab a region of the screen to a temporary buffer 


Syntax 
handle = GRABREGION(x, y, width, height) 


Description 
Grab a region of the screen with x and y as the location 


and with width and height in pixels. The region can be 
recalled by its handle and pasted using PLOTIMAGE. 


Example 
FOR n = @ TO 15 LOOP 


RECT(@,n*GHEIGHT/16, GWIDTH, GHEIGHT/16,1) 
REPEAT 


handle=GRABREGION(@, @, 200, 200) 

CLS 

PLOTIMAGE(handle, GWIDTH/2, GHEIGHT/2) 
UPDATE 

END 


Associated 

COPYREGION, FREEIMAGE, LOADIMAGE, PLOTIMAGE, 
SAVEREGION, SAVESCREEN, SCROLLDOWN, SCROLLLEFT, 
SCROLLRIGHT, SCROLLUP 
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GWIDTH 


Purpose 
Returns the current width of the display. 


Syntax 
width=GWIDTH 


Description 
This can be read to find current width of the display in 
either high resolution or low resolution pixels. 


Example 

REM Draw a circle in the centre of the 
screen 

CLS 

COLOUR = blue 

CIRCLE (GWIDTH/2,GHEIGHT/2,5@, TRUE) 
UPDATE 

END 


Associated 
GHEIGHT, ORIGIN, SETMODE 
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Functions, Constants & Procedures 


HIDESPRITE 


Purpose 
Remove a sprite from the screen. 


Syntax 
HIDESPRITE(spriteindex) 


Description 


This removes the sprite at the specified spriteindex from the 


screen. You do not have to erase a sprite from the screen when 


you move it, just call PLOTSPRITE with the new coordinates. 


Example 

CLS 

fuzelogo$="logo.bmp" 
s1=NEWSPRITE (1) 
S2=NEWSPRITE (1) 

LOADSPRITE (fuzelogo$,s1,@) 
LOADSPRITE (fuzelogo$,s2,@) 
PLOTSPRITE (s1,100,100,0) 
PLOTSPRITE (s2, 200,200,0) 
UPDATE 

WAIT (2) 

REM Remove a sprite from the screen 
HIDESPRITE (s2) 

UPDATE 

END 


Associated 
GETSPRITEH, GETSPRITEW, LOADSPRITE, NEWSPRITE, 


PLOTSPRITE, SPRITECOLLIDE, SPRITECOLLIDEPP, SPRITEOUT 
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HLINE 


Purpose 
Draw a horizontal line. 


Syntax 
HLINE(xpos1, xpos2, ypos) 


Description 


Draws a horizontal line on row y, from column xpos1 
to column xpos2. 


Example 

CLS 

COLOUR=red 

FOR ypos=@ TO GHEIGHT STEP 100 LOOP 
HLINE(@,GWIDTH, ypos) 

REPEAT 

UPDATE 

END 


Associated 
LINE, LINETO, VLINE 
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Functions, Constants & Procedures 


HTAB 


Purpose 
Set/Read the current text cursor horizontal position. 


Syntax 
HTAB=vaLue 
vaLue=HTAB 


Description 
Set/Read the current text cursor horizontal position. 


Example 

CLS 

FOR xpos = @ TO TWIDTH STEP 2 LOOP 
HTAB=xpos 
PRINT HTAB 

REPEAT 

END 


Associated 
HVTAB, VTAB, PRINTAT 
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HVTAB 


Purpose 
Move the current text cursor to the specified position. 


Syntax 
HVTAB (xpos, ypos ) 


Description 
The cursor is moved to the supplied column xpos and line 
ypos. Note that (0,0) is top-left of the text screen. 


Example 

CLS 

HVTAB(TWIDTH/2-3, THEIGHT/2) 
PRINT "CENTRE" 

HVTAB(@,@) 

END 


Associated 
HTAB, VTAB, PRINTAT 
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Functions, Constants & Procedures 


IF THEN 


Purpose 
Execute a statement conditionally. 


Syntax 
IF condition THEN {statement} 


Description 

The statement is executed when the condition evaluates 
to TRUE (not 0). Unlike some implementations of BASIC 
the THEN is required. 


Example 
PRINT "Press Space Bar to Continue" 
LOOP 
IF INKEY = 32 THEN BREAK 
REPEAT 
PRINT "Space Bar Pressed" 
END 
Associated 


ELSE, ENDIF, SWITCH 
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INK 


Purpose 
Set/Read the current text foreground colour. 


Syntax 
foregroundcoLour=INK 
INK=foregroundcoLlour 


Description 


Set/Read the current text foreground (ink) colour 


Example 
PAPER=black 
CLS 
string$="This is multicoloured text" 
FOR I=1 TO LEN(string$) LOOP 
INK=I MOD 15 + 1 
PRINT MID$(string$,1I-1,1); 
REPEAT 
INK=white 
PRINT 
END 


Associated 
PAPER 
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INKEY 


Purpose 
Get a single character code from the keyboard without 
pausing. 


Syntax 
ascitcode=INKEY 


Description 


This is similar to GET except that program execution is not 
paused; If no key is pressed, then -1 is returned. The following 
constants are predefined to test for special keys: KeyUp, 
KeyDown, KeyLeft, KeyRight, Keylns, KeyHome, KeyDel, 
KeyEnd, KeyPgUp, KeyPgDn, KeyF1, KeyF2, KeyF3, KeyF4, 
KeyF5, KeyF6, KeyF7, KeyF8, KeyF9, KeyF10, KeyF11, KeyF12. 


Example 
REM Show the ASCII code for the last key 
pressed 
LastKey = -1 
REM Press Esc to Quit 
LOOP 
Key=INKEY 
IF Key<>-1 AND Key<>LastKey THEN 
PRINT "Key Pressed: "; Key 
LastKey = Key 
ENDIF 
REPEAT 


Associated 
GET, INPUT, SCANKEYBOARD 
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INPUT 


Purpose 
Read data from the keyboard into a variable. 


Syntax 
INPUT [prompt$,] variable 


Description 

When FUZE BASIC encounters the INPUT statement, 
program execution stops, a question mark(?) is printed 
and it waits for you to type something. It then assigns 
what you typed to the variable. If you typed in a string 
when it was expecting a number, then it will assign zero to 
the number. To stop it printing the question mark, you 
can optionally give it a string to print. 


Example 

INPUT "What is your Name? ", Nameg$ 
PRINT "Hello " + Name$ 

END 


Associated 
INKEY 
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Functions, Constants & Procedures 


INPUT# 


Purpose 
Read data from a file. 


Syntax 
INPUT# handle, variable 


Description 

This works similarly to the regular INPUT instruction, but 
reads from the file identified by the supplied handle 
rather than from the keyboard. Note that unlike the 
regular keyboard INPUT instruction, INPUT# can only read 
one variable at a time. 


Example 
handle=OPEN("testfile.txt") 
PRINT# handle, "Hello World" 
REWIND(hand1le) 

INPUT# handle, record$ 

PRINT record$ 

CLOSE (handle) 

END 


Associated 
CLOSE, EOF, FFWD, OPEN, PRINT#, REWIND, SEEK 
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INT 


Purpose 
Return the integer part of a number. 


Syntax 
integerpart=INT (number) 


Description 


Returns the integer part of the specified number. 


Example 

PRINT "The integer part of PI is "; 
PRINT INT(PI) 

END 
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Functions, Constants & Procedures 


LEFT 


Purpose 
Turns the turtle to the left (counter clockwise) by the 
given angle. 


Syntax 
LEFT(angLe) 


Description 
Turns the virtual graphics turtle to the left (counter 
clockwise) by the given angle in the current angle units. 


Example 

REM Draw a box using turtle graphics 

CLS 

COLOUR=RED 

MOVE (5@) 

DEG 

LEFT(9@) 

MOVE (5@) 

PENDOWN 

FOR I = 1 TO 4 LOOP 
LEFT (90) 
MOVE (100) 

REPEAT 

UPDATE 

END 


Associated 
MOVE, MOVETO, PENDOWN, PENUP, RIGHT, TANGLE 
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LEFT$ 


Purpose 
Return the specified leftmost number of a characters from 
a string. 


Syntax 
substring$=LEFT$(string$,number) 


Description 

Returns a substring of stringS with number characters 
from the left (start) of the string. If number is greater than 
or equal to the length of stringS then the whole string is 
returned. 


Example 
string$="The quick brown fox" 
FOR I=1 TO 20 LOOP 

PRINT LEFT$(string$, I) 
REPEAT 
END 


Associated 
MIDS, RIGHTS 
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Functions, Constants & Procedures 


LEN 


Purpose 
Return the length of the specified character string. 


Syntax 
Length=LEN(string$) 


Description 
Returns the number of characters in the specified stringS. 


Example 
String$="The Quick Brown Fox" 
Chars=LEN(String$) 
PRINT "String Length is: ";Chars 
FOR I=@ TO Chars - 1 LOOP 
Char$=MID$(String$,1I,1) 
PRINT "Character No. ";I;" is "+Char$ 
REPEAT 
END 
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LINE 


Purpose 
Draw a line between two points 


Syntax 
LINE(xpos1, ypos1, xpos2,ypos2) 


Description 
Draw a line between point (xpos1,ypos1) and point 
(xpos2,ypos2) in the current COLOUR. 


Example 

CLS 

COLOUR = lime 

GH=GHE IGHT 

GW=GWIDTH 
LINE(10,10,10,GH-10) 
LINE(1@,GH-10,GW-10,GH-10) 
LINE (GW-10,GH-10,GW-10,10) 
LINE (GW-10,10,10,10) 
UPDATE 

END 


Associated 
HLINE, LINETO, VLINE 


Cx} 
mS 


Functions, Constants & Procedures 


LINETO 


Purpose 
Draw a line from the last point plotted. 


Syntax 
LINETO(xpos1, ypos1) 


Description 
Draws a line from the last point plotted (by the PLOT or 
LINE procedures) to point (xpos1,ypos1). 


Example 

CLS 

COLOUR = yellow 
ORIGIN(10,10) 
GH=GHEIGHT 
GW=GWIDTH 
LINETO(@,GH-20) 
LINETO(GW-20,GH-20) 
LINETO(GW-20, @) 
LINETO(@,@) 
UPDATE 

END 


Associated 
HLINE, LINE, VLINE 
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Functions, Constants & Procedures 


LOADIMAGE LOADMUSIC 


Purpose —_ Purpose 
Load an image file into memory. Load a music file into memory ready to be played. 


Syntax 


_ ‘ Syntax 
Rana C= HOD aMAGE sy Cname) handLe=LOADMUSIC (filename) 
Description . 
Load an image from a file with the specified filename. The Description 
returned handle can then be used to plot it on the screen with Loads an uncompressed music file in wav format (file 
PLOTIMAGE. extension .wav) from the file filename into memory and 
Example returns a handle which can then be used to play the music 
COLOUR=RED using the PLAYMUSIC function. 
RECT(@,@,50,5@, TRUE) 
COLOUR=WHITE Example 
LINE(@,50,50,50) handle=LOADMUSIC("takeoff.wav") 
TiNEteioece coy” SETMUSICVOL(7@) 
a tae 
LINE (50, 25,50, 5) PLAYMUSIC(handle, 1) 
LINE(25,0, 25,25) END 
LINE(@,0,50, 0) Associated 
SAVEREGION("bricks.bmp",@,0,50,5@) 
handle=LOADIMAGE("“bricks.bmp") PAUSEMUSIC, RESUMEMUSIC, SETMUSICVOL, STOPMUSIC 


FOR X=@ TO GWIDTH STEP 5@ LOOP 
FOR Y=@ TO GHEIGHT STEP 5@ LOOP 
PLOTIMAGE (handle, X,Y) 
REPEAT 
REPEAT 
UPDATE 
END 


Associated 
GETIMAGEH, GETIMAGEW, PLOTIMAGE, FREEIMAGE 


ey, OQ a. 
HAS HASH 


LOADSAMPLE 


Purpose 
Load a sound sample into memory ready to be played. 


Syntax 
handLe=LOADSAMPLE( filename) 


Description 

The LOADSAMPLE function loads a sound sample from the 
uncompressed WAV format file called filename and 
returns a handle to it so that it can be played using the 
PLAYSAMPLE function. You can load up to 32 sound 
samples into memory at the same time. 


Example 

channel=@ 

volume=70 

SETCHANVOL (channel, volume) 
intro=LOADSAMPLE ("pacman_intro.wav") 
PLAYSAMPLE (intro, channel, @) 
WAIT(4.5) 

END 


Associated 
PAUSECHAN, PLAYSAMPLE, RESUMECHAN, SETCHANVOL, 


STOPCHAN 
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Functions, Constants & Procedures 


LOADSPRITE 


Purpose 
Load a sprite from a file into memory. 


Syntax 
LOADSPRITE(filename$ , index, subindex) 


Description 

This loads a sprite from the supplied filenames into memory 
and associates it with the given sprite index and subindex. The 
index is the handle returned by a call to NewSprite and the 
subindex is the version of the sprite to allow for animation. The 
first subindex is 0. 


Example 

CLS 

REM Create a new sprite with 1 version 
SpriteIndex=NEWSPRITE(1) 

REM Load a sprite from a file 
fuzelogo$="logo.bmp" 
LOADSPRITE(fuzelogo$, SpriteIndex,@) 
REM Draw the sprite on the screen 
PLOTSPRITE(SpriteIndex, 200, 200,0) 
UPDATE 

END 


Associated 

GETSPRITEH, GETSPRITEW, HIDESPRITE, NEWSPRITE, 
PLOTSPRITE, SETSPRITETRANS, SPRITECOLLIDE, 
SPRITECOLLIDEPP 
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LOCAL 


Purpose 
Define variables to be local to a user defined procedure or 
function. 


Syntax 
LOCAL variabLe 


Description 
Allows a variable name to be reused in a procedure or 
function without affecting its value in the calling program. 


Example 
X=10 
PRINT "Global X="+STR$(X) 
Proc Test() 
PRINT "Global X="+STR$(X) 
END 
DEF PROC Test() 
PRINT "Global X="4STR$(X) 
LOCAL X 
X=5 
PRINT "Local X="+STR$(X) 
ENDPROC 


Associated 
DEF FN, DEF PROC 
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Functions, Constants & Procedures 


LOG 


Purpose 
Return the natural logarithm of the specified number. 


Syntax 
naturaLlogarithm = LOG(number) 


Description 

Returns the natural logarithm of the specified number. 
This is the opposite of the EXP function i.e. LOG(EXP(X)) = 
X. Logarithms are used in science to solve exponential 
radioactive decay problems and in finance to solve 
problems involving compound interest. 


Example 

X = EXP(1@) 

PRINT X // Will print 22026.46579 
PRINT LOG(X) // Will print 10 

END 


Associated 
EXP 
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MAX 


Purpose 
Returns the larger of two numbers. 


Syntax 
maxvaLue=MAX(number1 , number2) 


Description 


Returns the larger (highest value) of number1 or number2. 


Example 

REM Prints the value of number2 
number1=12.26 

number2=27.45 

PRINT MAX(number1, number2) 

END 


Associated 
MIN 
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Functions, Constants & Procedures 


MID$ 


Purpose 
Return characters from the middle of a string. 


Syntax 
MID$(string$, start, length) 


Description 

Returns the middle /ength characters of stringS starting 
from position start. The first character of the string is 
position number 0. 


Example 

REM Prints Quick 

string$="The Quick Brown Fox" 
PRINT MID$(string$,4,5) 

END 


Associated 
LEFTS, RIGHTS 
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MIN 


Purpose 
Returns the smaller of two numbers. 


Syntax 
minvaLue=MIN(number1 , number2) 


Description 
Returns the smaller (lowest value) of number1 or 
number2. 


Example 

REM Prints the value of number1 
number1=12.26 

number2=27.45 

PRINT MIN(number1, number2) 

END 


Associated 
MAX 
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Functions, Constants & Procedures 


MOUSEOFF 


Purpose 
Make the mouse cursor invisible. 


Syntax 
MOUSEOFF 


Description 
Make the mouse cursor invisible within the FUZE BASIC 
window. This is the default value. 


Example 
CLS 
MOUSEON 
LOOP 
GETMOUSE(x,y,b) 
LINETO(x,y) 
UPDATE 
REM LOOP colour if left button pressed 
IF b & 1 THEN 
COLOUR = COLOUR MOD 16 + 1 
ENDIF 
REM Exit if right button pressed 
REPEAT UNTIL b & 4 
MOUSEOFF 
END 


Associated 
GETMOUSE, MOUSEON, MOUSEX, MOUSEY, SETMOUSE 
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Functions, Constants & Procedures 


MOUSEON MOUSEX 


Purpose Purpose 
Make the mouse cursor visible. To find the mouse X position 
Syntax Syntax 
MOUSEON value = MOUSEX 
Description Description 
Make the mouse cursor visible within the FUZE BASIC Returns the X position of the current mouse location 
window. It is invisible by default. 
Example 

Example LOOP 
CLS PRINTAT(@,@); "Mouse X Position="; MOUSEX 
MOUSEON oa " 
LOOP REPEAT 

aoe Associated 

S 
UPDATE GETMOUSE, MOUSEOFF, MOUSEON, MOUSEY, 
REM LOOP colour if left button pressed SETMOUSE 


IF b & 1 THEN 
COLOUR = COLOUR MOD 16 + 1 
ENDIF 
REM Exit if right button pressed 
REPEAT UNTIL b & 4 
MOUSEOFF 
END 


Associated 
GETMOUSE, MOUSEOFF, MOUSEX, MOUSEY, SETMOUSE 
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MOUSEY 


Purpose 
To find the mouse Y position 


Syntax 
value = MOUSEY 


Description 
Returns the Y position of the current mouse location 


Example 
LOOP 
PRINTAT(@,@); "Mouse Y Position="; MOUSEY 


a 
REPEAT 


Associated 
GETMOUSE, MOUSEOFF, MOUSEON, MOUSEX, 


SETMOUSE 
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Functions, Constants & Procedures 


MOVE 


Purpose 
Move the graphics turtle forward 


Syntax 
MOVE (distance) 


Description 
This causes the virtual graphics turtle to move forwards 
distance in screen pixels. A line will be drawn if the pen 
is 
down. 
Example 
CLS 
COLOUR=RED 
MOVE (50) 
DEG 
LEFT(90) 
MOVE (50) 
PENDOWN 
FOR I = 1 TO 4 LOOP 
LEFT(90) 
MOVE (100) 
REPEAT 
UPDATE 
END 


Associated 
LEFT, MOVETO, PENDOWN, PENUP, RIGHT, TANGLE 
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MOVETO 


Purpose 
Move the graphics turtle to a point on the screen. 


Syntax 
MOVETO(xpos, ypos ) 


Description 

This moves the virtual graphics turtle to the absolute 
location (xpos,ypos). A line will be drawn if the pen is 
down. 


Example 

REM Draw a spiral in the centre of the 

screen 

CLS 

COLOUR=RED 

PENUP 

MOVETO(GWIDTH/2, GHEIGHT/2) 

PENDOWN 

FOR I=2 TO GWIDTH LOOP 
MOVE (I) 
RIGHT (30) 

REPEAT 

UPDATE 

END 


Associated 
LEFT, MOVE, PENDOWN, PENUP, RIGHT, TANGLE 
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Functions, Constants & Procedures 


NEWSPRITE 


Purpose 
Create a new sprite. 


Syntax 
index=NEWSPRITE (count) 


Description 

This returns an index (or handle) to the internal sprite 
data. You need to use the index returned in all future 
sprite handling functions/procedures. The count 
argument specifies the number of different versions of 
the sprite. 


Example overleaf... 
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Example 
CLS 
COLOUR=YELLOW 
CIRCLE(100,100,5@, TRUE) 
SAVEREGION("pac1.bmp",5@,50,101, 101) 
COLOUR=BLACK 
TRIANGLE (100,100,150,125,150,75, TRUE) 
SAVEREGION("pac2.bmp",5@,5@,101, 101) 
TRIANGLE (100,100,150,150,150,50, TRUE) 
SAVEREGION("pac3.bmp",5@,50,101, 101) 
CLS 
pacman=NEWSPRITE(3) 
LOADSPRITE("pac1.bmp", pacman, @) 
LOADSPRITE("pac2.bmp", pacman, 1) 
LOADSPRITE("pac3.bmp", pacman, 2) 
FOR X=1 TO GWIDTH STEP 25 LOOP 
FOR S=@ TO 2 LOOP 

PLOTSPRITE (pacman, X, GHEIGHT/2,S) 

UPDATE 

WAIT(.1) 

REPEAT 

REPEAT 
HIDESPRITE (pacman) 
END 


Associated 

GETSPRITEH, GETSPRITEW, HIDESPRITE, LOADSPRITE, 
PLOTSPRITE, SETSPRITETRANS, SPRITECOLLIDE, 
SPRITECOLLIDEPP 


Functions, Constants & Procedures 


NUMFORMAT 


Purpose 
Control how numbers are formatted. 


Syntax 
NUMFORMAT (width, decimaLs) 


Description 

You can affect the way numbers are printed using the 
NUMFORMAT procedure. This takes 2 arguments, the 
width specifying the total number of characters to print 
and the decimals the number of characters after the 
decimal point. Numbers printed this way are right- 
justified with leading spaces inserted if required. 
NUMFORMAT (0,0) restores the output to the general 
purpose format used by default. 


Example 

NUMFORMAT (6,4) 

REM Prints 3.1416 
PRINT PI 
NUMFORMAT (@, @) 

REM Prints 3.141592654 
PRINT PI 

END 


Associated 
PRINT, PRINTAT 
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OPEN 


Purpose 
Open a file for read or write. 


Syntax 
handLe=OPEN( filename$ ) 


Description 

The OPEN function opens a file and makes it available for 
reading or writing and returns the numeric handle 
associated with the file. The file is created if it doesn’t 
exist, or if it does exist the file pointer is positioned at the 
start of the file. 


Example 

handle = OPEN("testfile.txt") 
PRINT# handle, "Colin" 

PRINT# handle, 47 

CLOSE (handle) 

handle = OPEN("testfile.txt") 
INPUT# handle, Name$ 

INPUT# handle, Age 

CLOSE (handle) 

PRINT "Name: " + Name$ 

PRINT "Age: "; Age 

END 


Associated 
CLOSE, EOF, FFWD, INPUT#, PRINT#, REWIND, SEEK 


Cx} 
me OS 


Functions, Constants & Procedures 


ORIGIN 


Purpose 
Move the graphics origin. 


Syntax 
ORIGIN(xpos, ypos) 


Description 

This changes the graphics origin for the Cartesian plotting 
procedures. The xpos, ypos coordinates are always 
absolute coordinates with (0,0) being bottom left (the 
default). 


Example 

CLS 

COLOUR=yellow 

REM Move the origin to the screen centre 
ORIGIN(GWIDTH/2, GHEIGHT/2) 
PLOT(-100, -100) 
LINETO(-100,100) 
LINETO(100, 100) 

LINETO(10@, -100) 

LINETO( -100, -100) 

UPDATE 

ORIGIN(@,@) 

END 


Associated 
GHEIGHT, GWIDTH 
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PAPER 


Purpose 
Set/Read the current text background colour. 


Syntax 
backgroundcoLour=PAPER 
PAPER=backgroundcoLlour 


Description 

Set/Read the current text background (paper) colour. 
Clear screen (CLS) will set the entire background to this 
colour. 


Example 

PRINT "Text background colour "; PAPER 
PAPER=RED 

PRINT "Text background colour "; PAPER 
PAPER=7 

PRINT "Text background colour "; PAPER 
END 


Associated 
INK, PAPERON, PAPEROFF 
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Functions, Constants & Procedures 


PAPEROFF 


Purpose 
Switches the text background colour off. 


Syntax 
PAPEROFF 


Description 


This function switches the background text colour off. It 
can be turned on or off so that the text background does 
not obscure whatever is behind it. 


Example 
LOOP 
INK = Orange 
PaperOn 
fontSize (RND (10) + 1) 
printAt (RND(tWidth), RND(tHeight - 1)); "ON"; 
WAIT(.3) 
INK = Yellow 
PaperOff 
fontSize (RND (10) + 1) 
printAt (RND(tWidth), RND(tHeight - 1)); "OFF"; 
WAIT(.3) 
REPEAT 


Associated 
INK, PAPER, PAPERON 
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PAPERON 


Purpose 
Sets text background colour to display 


Syntax 
PAPERON 


Description 


This function switches the background text colour on. 
It can be turned on or off so that the text background 
does not obscure whatever is behind it. 


Example 
LOOP 
INK = Orange 
PaperOn 
fontSize (RND (10) + 1) 


printAt (RND(tWidth), RND(tHeight - 1)); "ON"; 


WAIT(.3) 

INK = Yellow 

PaperOff 

fontSize (RND (10) + 1) 


printAt (RND(tWidth), RND(tHeight - 1)); "OFF"; 


WAIT(.3) 
REPEAT 


Associated 
INK, PAPER, PAPEROFF 
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Functions, Constants & Procedures 


PAUSECHAN 


Purpose 
Pause the playing of a sound sample. 


Syntax 
PAUSECHAN(handLe) 


Description 

This function pauses the playing of the sound sample 
associated with the handle returned by LOADSAMPLE 
that has been started using PLAYSAMPLE. The sample 
can be resumed where it left off using RESUMECHAN 


Example 

channel=@ 

volume=70 

SETCHANVOL (channel, volume) 
intro=LOADSAMPLE ("pacman_intro.wav" ) 
PLAYSAMPLE (intro, channel, ®@) 
WAIT(3) 

PAUSECHAN( intro) 

Wait(2) 

RESUMECHAN( intro) 

END 


Associated 
LOADSAMIPLE, PLAYSAMPLE, RESUMECHAN, 


SETCHANVOL, STOPCHAN 
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PAUSEMUSIC 


Purpose 
Pause a playing music file 


Syntax 
PAUSEMUSIC 


Description 
Pauses a playing music track which can them be restarted 
using RESUMEMUSIC. 


Example 
handle=LOADMUSIC("takeoff.wav" ) 
SETMUSICVOL(7@) 
PLAYMUSIC(handle, 1) 

PAUSEMUSIC 


Associated 
LOADMUSIC, RESUMEMUSIC, SETMUSICVOL, STOPMUSIC 
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PENDOWN 


Purpose 
Start drawing using the graphics turtle. 


Syntax 
PENDOWN 


Description 

This lowers the “pen” that the virtual graphics turtle is 
using to draw with. Nothing will be drawn until you 
execute this procedure. 


Example 

REM Draw a spiral in the centre of the 

screen 

CLS 

COLOUR=RED 

PENUP 

MOVETO(GWIDTH/2, GHEIGHT/2) 

PENDOWN 

FOR I=2 TO GWIDTH LOOP 
MOVE (TI) 
RIGHT (30) 

REPEAT 

UPDATE 

END 


Associated 
LEFT, MOVE, MOVETO, PENUP, RIGHT, TANGLE 
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PENUP 


Purpose 
Stop drawing using the graphics turtle. 


Syntax 
PENUP 


Description 

This lifts the “pen” that the virtual graphics turtle uses to 
draw. You can move the turtle without drawing while the 
pen is up. 


Example 

REM Draw a spiral in the centre of the 

screen 

CLS 

COLOUR=RED 

PENUP 

MOVETO(GWIDTH/2 ,GHEIGHT/2) 

PENDOWN 

FOR I=2 TO GWIDTH LOOP 
MOVE (I) 
RIGHT (30) 

REPEAT 

UPDATE 

END 


Associated 
LEFT, MOVE, MOVETO, PENDOWN, RIGHT, TANGLE 
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Functions, Constants & Procedures 


PI 


Purpose 
Returns the value of the constant pi. 


Syntax 
vaLueofpi=PI 


Description 

Returns an approximation of the value of the constant pi 
which is the ratio of a circle’s circumference to its 
diameter (approximately 3.141592654) which is widely 
used in mathematics, specifically trigonometry and 
geometry. 


Example 

PRINT FN AreaOfCircle(12) 

END 

DEF FN AreaOfCircle(withRadius) 
LOCAL result 
result=PI*withRadius*withRadius 

= result 
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PINMODE 


Purpose 
Configure the mode of a pin on the Pi’s GPIO. 


Syntax 
PINMODE (pinno, pinmode ) 


Description 

Configures the mode of a pin on the Pi’s GPIO. It takes an 
argument which specifies the mode of the pin - input, 
output or PWM output. The modes are: 

0 pinINPUT 

1 pinOUTPUT 

2 pinPWM 


Example 

REM Set pin 12 to input 

PINMODE (12,1) 

REM Wait for button to be pushed 
UNTIL DIGITALREAD(12) LOOP 
REPEAT 

PRINT "Button Pushed" 

END 


Associated 
DIGITALREAD, DIGITALWRITE, PWMWRITE, 


SOFTPWMWRITE 


Functions, Constants & Procedures 


PLAYMUSIC 


Purpose 
Start playing a music track. 


Syntax 
PLAYMUSIC(handLe, repeats ) 


Description 

This function plays a music track previously loaded using 
the LOADMUSIC function which returns the handle. The 
repeats are the number of times to play the track. 


Example 
handle=LOADMUSIC("takeoff.wav" ) 
SETMUSICVOL(7@) 
PLAYMUSIC(handle, 1) 

END 


Associated 
LOADMUSIC, PAUSEMUSIC, RESUMEMUSIC, 


SETMUSICVOL, STOPMUSIC 
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Functions, Constants & Procedures 


PLAYSAMPLE PLOT 


Purpose Purpose 

Start playing a sound sample. Draw a single point on the screen. 
Syntax Syntax 

PLAYSAMPLE (handLe, channeL, Loops) PLOT( xpos, ypos ) 
Description Description 

This function plays a sound previously loaded using the This plots a single pixel at screen location (xpos,ypos) in 
LOADSAMPLE function which returns the handle. The the selected graphics mode in the selected colour. Note 
channel is 0, 1, 2 or 3 which lets you play up to 4 that (0,0) is bottom left by default. 
concurrent samples. The /Joops parameter is different to Example 

the repeats one in the PLAYMUSIC function. Here it means CLS 

the number of times to loop the sample — zero means no LOOP 

loops which means play it ONCE. IF INKEY<>-1 THEN BREAK 
Example xpos=RND(GWIDTH) 
channel=0 ypos=RND (GHEIGHT ) 
volume=70 COLOUR=RND(16) 
SETCHANVOL (channel, volume) PLOT(xpos, ypos) 
intro=LOADSAMPLE("pacman_intro.wav") UPDATE 

PLAYSAMPLE (intro, channel, ®@) REPEAT 

WAIT(4.5) END 

END 

Associated 

LOADSAMPLE, PAUSECHAN, RESUMECHAN, SETCHANVOL, 

STOPCHAN 
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PLOTIMAGE 


Purpose 
Display a loaded image on the screen. 


Syntax 
PLOTIMAGE (handLe, xpos ,ypos) 


Description 

Plot an image previously loaded using LOADIMAGE 
(using the handle returned by LOADIMAGE) on the 
screen at coordinates (xpos,ypos). 


Example 
COLOUR=RED 
RECT(@,0,50,5@, TRUE) 
COLOUR=WHITE 
LINE(@,50,50,50) 
LINE(@,25,50,25) 
LINE(@,25,0, 50) 
LINE(50,25,50,50) 
LINE(25,0,25,25) 
LINE(@,0,50,@) 
SAVEREGION("bricks.bmp", 2,2, 50,50) 
handle=LOADIMAGE ("bricks.bmp") 
FOR X=@ TO GWIDTH STEP 5@ LOOP 
FOR Y=@ TO GHEIGHT STEP 5@ LOOP 
PLOTIMAGE (handle, X,Y) 
REPEAT 
REPEAT 
UPDATE 
END 


Associated 


GETIMAGEH, GETIMAGEW, LOADIMAGE, FREEIMAGE 
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Functions, Constants & Procedures 


PLOTSPRITE 


Purpose 
Draw a sprite on the screen. 


Syntax 
PLOTSPRITE (index, xpos, ypos, subindex) 


Description 

This plots the sprite index and version subindex at the 
coordinates (xpos, ypos). The coordinates specify the bottom- 
left corner of the bounding rectangle of the sprite. 


Example 

CLS 

REM Create a new sprite with 1 version 
SpriteIndex=NEWSPRITE(1) 

REM Load a sprite from a file 
fuzelogo$="/usr/share/fuze/logo.bmp" 
LOADSPRITE(fuzelogo$, SpriteIndex,@) 
REM Draw the sprite on the screen 
PLOTSPRITE(SpriteIndex, 200, 200,0) 
UPDATE 

END 


Associated 

GETSPRITEH, GETSPRITEW, HIDESPRITE, LOADSPRITE, 
NEWSPRITE, SETSPRITEALPHA, SETSPRITEANGLE, 
SETSPRITEFLIP, SETSPRITESIZE, SETSPRITETRANS, 
SPRITECOLLIDE, SPRITECOLLIDEPP, SPRITEOUT 
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POLYEND 


Purpose 
Draw the filled polygon started by PolyStart. 


Syntax 
POLYEND 


Description 

This marks the end of drawing a polygon. When this is 
called, the stored points will be plotted on the screen and 
the polygon will be filled. 


Example 

CLS 

PROC Hexagon(2@0, 200,50,Red) 

UPDATE 

END 

DEF Proc Hexagon(x,y,1,c) 
COLOUR=c 
POLYSTART 
POLYPLOT(x+1,y) 
POLYPLOT(x+1/2,y-1*SQRT(3/2)) 
POLYPLOT(x-1/2, y-1*SQRT(3/2)) 
POLYPLOT(x-1,y) 
POLYPLOT(x-1/2, y+1*SQRT (3/2) ) 
POLYPLOT(x+1/2, y+1*SQRT(3/2)) 
POLYEND 

ENDPROC 


Associated 
POLYPLOT, POLYSTART 
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Functions, Constants & Procedures 


POLYPLOT 


Purpose 
Add a point to a filled polygon. 


Syntax 
POLYPLOT (xpos, ypos ) 


Description 
This remembers the given xpos,ypos coordinates as part of a 


filled polygon. Nothing is actually drawn on the screen until the 
PolyEnd instruction is executed. Polygons can have a maximum 


of 64 points. 


Example 

CLS 

PROC Hexagon(2@0, 200,50,Red) 

UPDATE 

END 

DEF Proc Hexagon(x,y,1,c) 
COLOUR=c 
POLYSTART 
POLYPLOT(x+1,y) 
POLYPLOT(x+1/2, y-1*SQRT(3/2)) 
POLYPLOT(x-1/2, y-1*SQRT(3/2)) 
POLYPLOT(x-1,y) 
POLYPLOT(x-1/2, y+1*SQRT(3/2)) 
POLYPLOT(x+1/2, y+1*SQRT(3/2)) 
POLYEND 

ENDPROC 


Associated 
POLYEND, POLYSTART 
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POLYSTART 


Purpose 
Start drawing a filled polygon. 


Syntax 
POLYSTART 


Description 


This marks the start of drawing a filled polygon. 


Example 

CLS 

PROC Hexagon(2@0, 200,50,Red) 

UPDATE 

END 

DEF Proc Hexagon(x,y,1,c) 
COLOUR=c 
POLYSTART 
POLYPLOT(x+1,y) 
POLYPLOT(x+1/2,y-1*SQRT(3/2)) 
POLYPLOT(x-1/2, y-1*SQRT(3/2)) 
POLYPLOT(x-1,y) 
POLYPLOT(x-1/2, y+1*SQRT (3/2) ) 
POLYPLOT(x+1/2, y+1*SQRT(3/2)) 
POLYEND 

ENDPROC 


Associated 
POLYEND, POLYPLOT 
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Functions, Constants & Procedures 


PLOTTEXT 


Purpose 
Display text using graphic coordinates. 


Syntax 
PLOTTEXT(“text”, xpos, ypos) 


Description 


The PRINT command uses the cursor coordinates to 
display text whereas PLOTTEXT can position text at a 
specified pixel location 


Example 
LOOP 
INK = RND (30) 
fontSize (RND (10) + 1) 
plotText("HELLO", RND(gWidth), RND(gHeight-1) ) 
UPDATE 
REPEAT 


Associated 
PRINT, PRINTAT 
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PRINT 


Purpose 
Output text to the screen 


Syntax 
PRINT {text}{; text} 


Description 

Outputting text to the screen is done via the PRINT 
command. The PRINT command is quite versatile and will 
print any combination of numbers and strings separated 
by the semi-colon (;). A trailing semi-colon will suppress 
the printing of a new line. 


Example 

PRINT "Hello Colin" 
PRINT "Hello "; 
name$="Colin" 

PRINT name$ 

PRINT "Hello "; name$ 
END 


Associated 
NUMFORMAT, PRINTAT 
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Functions, Constants & Procedures 


PRINT# 


Purpose 
Print data to a file. 


Syntax 
PRINT# handle,data 


Description 

The PRINT# instruction acts just like the regular PRINT 
instruction except that it sends data to the file identified 
by the supplied file-handle rather than to the screen. 
Numbers are formatted according to the settings of 
NUMFORMAT. It is strongly recommended to only print 
one item per line if you are going to read those items back 
into a FUZE BASIC program again. 


Example 

handle = OPEN("testfile.txt") 
PRINT# handle, "Hello World" 
CLOSE (handle) 

END 


Associated 
CLOSE, EOF, FFWD, INPUT#, OPEN, REWIND, SEEK 
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PRINTAT 


Purpose 
Set the text cursor position and print 


Syntax 
PRINTAT( x, y ); "text" 


Description 

Use to position the text cursor at the specified location 
and print. Useful for laying out text and or variables at 
any preferred screen location. 


Example 

name$ = "Sam" 

age = 10 

PRINTAT( 8, 5 ); "My name is "; name$ 
PRINTAT( 5, 10 ); "I am"; age 3; " years 
old" 

END 


Associated 
CHRS, HTAB, HVTAB, INK, 


PAPER, PRINT, PRINT, THEIGHT, TWIDTH, VTAB 
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Functions, Constants & Procedures 


PROC 


Purpose 
Call a user defined procedure. 


Syntax 
PROC name({argument}{,argument}) 


Description 


Calls the specified user defined procedure called name 
with the specified arguments. Once the procedure has 
been executed control returns to the command following. 


Example 
CLES 
LOOP 
x=RND(TWIDTH) 
y=RND(THEIGHT) 
c=RND(15) 
Text$=”Blossom” 
PROC text(text$, x, y, Cc) 
REPEAT 
END 
DEF PROC text(text$, x, y, Cc) 
INK=c 
PRINTAT(x,y); text$ 
ENDPROC 


Associated 
DEF PROC, ENDPROC 
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PWMWRITE 


Purpose 
Output a PWM waveform on the selected pin. 


Syntax 
PWMWRITE(pinno, pinvaLue) 


Description 

This procedure outputs a PWM waveform on the selected 
pin. The pin must be configured for PWM mode 
beforehand. The value set should be between 0 and 100. 


Example 

REM Set pin 1 to PWM output mode 
PINMODE (1, 2) 

PWMWRITE (1,50) 

END 


Associated 
DIGITALREAD, DIGITALWRITE, PINMODE 


Functions, Constants & Procedures 


RAD 


Purpose 
Set angle units to radians. 


Syntax 
RAD 


Description 
Switches the internal angle system to radians. There are 2 
* Pl radians in a full circle. 


Example 

REM Draw an ellipse in the screen centre 

CLS 

RAD 

FOR Angle=@ TO 2 * PI STEP @.01 LOOP 
Xpos=100*COS(Angle)+GWIDTH / 2 
Ypos=50*SIN(Angle)+GHEIGHT / 2 
PLOT (Xpos, Ypos) 

REPEAT 

END 


Associated 
CLOCK, DEG 
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READ 


Purpose 


Read data into program variables. 


Syntax 


READ variable {,variabLe} 


Description 


To get data into your program variables, we use the READ 
instruction. We can read one, or many items of data at a 


time. 


Example 


REM Load the name of the days of the 
REM week into a string array 
DATA "Monday", "Tuesday", "Wednesday" 
DATA "Thursday", "Friday", "Saturday" 
DATA "Sunday" 
DIM DaysOfWeek$(7) 
FOR Day = 1 TO 7 LOOP 

READ DaysOfWeek$(Day) 


REPEAT 


PRINT "The third day of the week is "; 
PRINT DaysOfWeek$(3) 


END 


Associated 


DATA, RESTORE 
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RECT 


Purpose 
Draw a rectangle on the screen. 


Syntax 
RECT(xpos, ypos,width, height, filL) 


Description 

Draws a rectangle at position (xpos,ypos) with width and 
height. The final parameter, fill is either TRUE or FALSE, 
and specifies filled (TRUE) or outline (FALSE). 


Example 

CLS 

LOOP 
COLOUR=RND(16) 
x=RND(GWIDTH) 
y=RND(GHEIGHT) 
w=RND(GWIDTH / 4) 
h=RND(GHEIGHT / 4) 
f=RND(2) 
RECT(x,y,w,h, f) 
UPDATE 
IF INKEY<>-1 THEN BREAK 

REPEAT 

END 


Associated 
CIRCLE, ELLIPSE, TRIANGLE 
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REPEAT UNTIL 


Purpose 
Loop until the specified condition is met. 


Syntax 
LOOP 
{statements} 
REPEAT UNTIL condition 


Description 
Execute the statements one or more times until the 
condition is TRUE (not 0). 


Example 
Number=INT(RND(10)) + 1 
Guess=0 
REM Guessing Game 
PRINT "Guess a Number Between 1 and 10" 
LOOP 
INPUT "Enter Your Guess: ", Guess 
IF (Number<>Guess) THEN 
PRINT “Incorrect Guess Again" 
ENDIF 
REPEAT UNTIL Number = Guess 
PRINT "You are Correct!" 
END 


Associated 


BREAK, CONTINUE, LOOP, LOOP REPEAT, FOR REPEAT, 


UNTIL REPEAT, WHILE REPEAT 
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RESTORE 


Purpose 
Reset the DATA pointer. 


Syntax 
RESTORE 


Description 
With no /ineno specified resets the READ command to the 
very first DATA statement in the program. 


Example 
DATA "Monday", "Tuesday", "Wednesday" 
DATA "Thursday", "Friday", "Saturday", 
"Sunday" 
FOR Day = 1 TO 3 LOOP 
READ DayOfWeek$ 
REPEAT 
PRINT DayOfWeek$ 
RESTORE 
FOR Day = 1 TO 4 LOOP 
READ DayOfWeek$ 
REPEAT 
PRINT DayOfWeek$ 
END 


Associated 
DATA, READ 
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RESUMECHAN 


Purpose 
Resume the playing of a sound sample. 


Syntax 
RESUMECHAN (handLe) 


Description 

This function resumes the playing of the sound sample 
associated with the handle returned by LOADSAMPLE 
that has been started using PLAYSAMPLE and paused 
using PAUSECHAN. 


Example 

channel=@ 

volume=70 

SETCHANVOL (channel, volume) 
intro=LOADSAMPLE ("pacman_intro.wav") 
PLAYSAMPLE (intro, channel, @) 
WAIT(3) 

PAUSECHAN( intro) 

WAIT(2) 

RESUMECHAN(intro) 

END 


Associated 


LOADSAMPLE, PAUSECHAN, PLAYSAMPLE, SETCHANVOL, 


STOPCHAN 
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RESUMEMUSIC 


Purpose 
Resumes music playing after it has been paused. 


Syntax 
RESUMEMUSIC 


Description 
Resumes the playing of a music track previously paused 
using PAUSEMUSIC. 


Example 
handle=LOADMUSIC("takeoff.wav" ) 
SETMUSICVOL(7®) 
PLAYMUSIC(handle, 1) 

PAUSEMUSTIC 

WAIT(1) 

RESUMEMUSTIC 


Associated 
LOADMUSIC, PAUSEMUSIC, SETMUSICVOL, STOPMUSIC 
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REWIND 


Purpose 
Move the file pointer to the start of a file. 


Syntax 
REWIND(handLe) 


Description 
Move the file pointer to the start of the file specified by 
handle. 


Example 

handle=OPEN ("“rewindtest.txt") 
PRINT# handle, "First Record" 
PRINT# handle, "Second Record" 
CLOSE (handle) 
handle=OPEN("rewindtest.txt") 
INPUT# handle, record$ 

PRINT record$ 

REWIND(hand1le) 

REM reads the first record again 
INPUT# handle, record$ 

PRINT record$ 

CLOSE (handle) 

END 


Associated 
CLOSE, EOF, FFWD, INPUT#, OPEN, PRINT#, SEEK 
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RGBCOLOUR 


Purpose 
Set the current graphical plot colour to an RGB 
(Red,Green, Blue) value. 


Syntax 
RGBCOLOUR (red, green, blue) 


Description 
This sets the current graphical plot colour to an RGB 
(Red,Green, Blue) value. The values should be from 0 to 255. 


Example 

CLS 

PRINT "Draw Spectrum" 

FOR v = @ TO 255 LOOP 
RGBCOLOUR(255,v,@) 
LINE(v, 300,v, 40) 
RGBCOLOUR(v, 255,0) 
LINE(511-v, 300,511-v, 400) 
RGBCOLOUR(@, 255-v,v) 
LINE(512+v, 300,512+v, 400) 
RGBCOLOUR(@,v, 255) 

LINE (768+v, 300, 768+v, 400) 

REPEAT 

UPDATE 

END 


Associated 
COLOUR, INK, PAPER 
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RIGHT 


Purpose 


Turns the turtle to the right (clockwise) by the given angle. 


Syntax 
RIGHT (angle) 


Description 
Turns the virtual graphics turtle to the right (clockwise) by 
the given angle in the current angle units. 


Example 
CLS 
PRINT "Draw Pink Hexagon" 
PENUP 
COLOUR = PINK 
PENDOWN 
FOR I = 1 TO 6 LOOP 
RIGHT (6@) 
MOVE (100) 
REPEAT 
END 


Associated 
LEFT, MOVE, MOVETO, PENDOWN, PENUP, TANGLE 
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RIGHT$ 


Purpose 
Return the specified rightmost number of a characters 
from a string. 


Syntax 
substring$=RIGHT$(string$,number ) 


Description 

Returns a substring of stringS with number characters 
from the right (end) of the string. If number is greater 
than or equal to the length of stringS then the whole 
string is returned. 


Example 
String$="The quick brown fox" 
FOR I=1 TO 2@ LOOP 

PRINT RIGHT$(String$, I) 
REPEAT 
END 


Associated 
LEFTS, MIDS 
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ROTATEIMAGE 


Purpose 
Return the specified rightmost number of a characters 
from a string. 


Syntax 
substring$=RIGHT$(string$,number ) 


Description 

Returns a substring of stringS with number characters 
from the right (end) of the string. If number is greater 
than or equal to the length of stringS then the whole 
string is returned. 


Example 

image = loadImage ("screen.png" ) 
plotImage (image, 9, @) 
UPDATE 

WAIT (2) 

CLS 

rotateImage (image, 90) 
plotImage (image, 9, @) 
UPDATE 

WAIT (2) 

END 


Associated 
LOADIMAGE, SCALEIMAGE 
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RND 


Purpose 
Generate a random number in a given range. 


Syntax 
random=RND (range) 


Description 

This function returns a random number based on the 
value of range. If range is zero, then the last random 
number generated is returned, if range is 1, thena 
random number from 0 to 1 is returned, otherwise a 
random number from 0 up to, but not including range is 
returned. 


Example 
DiceRoll=RND(6)+1 
PRINT "Dice Roll: "; DiceRoll 
CoinToss=RND(2) 
IF CoinToss=@ THEN 
PRINT "Heads" 
ELSE 
PRINT "Tails" 
ENDIF 
END 


Associated 
SEED 


On main index 90 


SAVEREGION 


Purpose 
Save a snapshot of an area of the screen to an image file. 


Syntax 
SAVEREGION(file$, xpos, ypos,width, height) 


Description 

This takes a snapshot of an area of the current screen, 
specified by the rectangle with bottom left at coordinates 
(xpos,ypos) of specified width and height, and saves it to 
the file named fileS in a bitmap (.bmp) format. 


Example (overleaf) 
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SAVEREGION Example 


CLS 
COLOUR=YELLOW 
CIRCLE(100,100,5@, TRUE) 
SAVEREGION("pac1.bmp",5@,50,101, 101) 
COLOUR=BLACK 
TRIANGLE (100,100,150,125,150,75, TRUE) 
SAVEREGION("pac2.bmp",5@,50,101, 101) 
TRIANGLE (100,100,150, 150,150,50, TRUE) 
SAVEREGION("pac3.bmp",5@,50,101, 101) 
CLS 
pacman=NEWSPRITE(3) 
LOADSPRITE("pac1.bmp", pacman, @) 
LOADSPRITE("pac2.bmp", pacman, 1) 
LOADSPRITE("pac3.bmp", pacman, 2) 
FOR X=1 TO GWIDTH STEP 25 LOOP 
FOR S=@ TO 2 LOOP 

PLOTSPRITE (pacman, X, GHEIGHT/2,S) 

UPDATE 

WAIT(.1) 

REPEAT 

REPEAT 
HideSprite(pacman) 
END 


Associated 
SAVESCREEN 
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SAVESCREEN 


Purpose 
Save a snapshot of the screen to an image file. 


Syntax 
SAVESCREEN(fiLename$ ) 


Description 
This takes a snapshot of the current screen and saves it to 
the filename given in a bitmap (.bmp) format file 


Example 

CLS 

PRINT "Draw Spectrum" 

FOR v = ® TO 255 LOOP 
RGBCOLOUR(255,v,0) 
LINE(v, 300, v,400) 
RGBCOLOUR (v, 255,0) 
LINE(511-v, 300,511-v, 400) 
RGBCOLOUR(@, 255-v,v) 
LINE(512+v, 300,512+v, 400) 
RGBCOLOUR(@,v, 255) 
LINE(768+v, 300, 768+v, 400) 

REPEAT 

UPDATE 

SAVESCREEN("screenshot. bmp" ) 

END 


Associated 
SAVEREGION 
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SCALEIMAGE 


Purpose 
Resize a loaded image. 


Syntax 
SCALEIMAGE(handLle, percent) 


Description 
Scales a preloaded image by a specified percentage. 


Example 

image = loadImage ("screen.png" ) 
plotImage (image, 9, @) 
UPDATE 

WAIT (2) 

CLS 

scaleImage (image, 50) 
plotImage (image, 9, @) 
UPDATE 

WAIT (2) 

END 


Associated 
LOADIMAGE, ROTATEIMAGE 
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SCANKEYBOARD 


Purpose 
Scan for a key pressed down. 


Syntax 
SCANKEYBOARD (keycode ) 


Description 

Allows you to detect that any of the keys have been 
pressed (including special keys) and also to detect mutiple 
keys pressed at the same time. The keycode parameter 
indicates the key press to be scanned for e.g scanSpace is 
the space bar. See the end of this guide for a full list of 
SCANKEYBOARD keycodes. 


Example 

PRINT "Press Ctrl-Alt-Delete" 

LOOP 
LCtrl = SCANKEYBOARD(scanLCtr1) 
LA1t = SCANKEYBOARD(scanLAlt) 
Delete = SCANKEYBOARD(scanDelete) 


Reboot = LCtrl AND LA1t AND Delete 
REPEAT UNTIL Reboot 
PRINT "Rebooting..." 
CLEARKEYBOARD 
END 


Associated 
CLEARKEYBOARD, GET, INKEY, INPUT 
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SCLOSE 


Purpose 
Close an open serial port. 


Syntax 
SCLOSE(handLe) 


Description 

This closes a serial port and frees up any resources used 
by it. It’s not strictly necessary to do this when you end 
your program, but it is considered good practice. 


Example 

REM Read a character from a serial port 
arduino=SOPEN("/dev/ttyUSB@", 115200) 
char$=SGET$(arduino) 

PRINT char$ 

SCLOSE(arduino) 

END 


Associated 
SGET, SGETS, SOPEN, SPUT, SPUTS, SREADY 
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SCROLLDOWN 
SCROLLLEFT 
SCROLLRIGHT 
SCROLLUP 


Purpose 
Scroll a region of the screen down. 


Syntax 
SCROLLDOWN( xpos, ypos,width, height, pixels) 


Description 

Scroll the region of the screen specified by the rectangle 
at position (xpos,ypos) with dimensions width X height 
down by the specified number of pixels. 


Example overleaf 
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Example 

CLS 

W=100 // Width 

S=2 // Step Size 

X=(GWIDTH-W) /2 

Y=(GHEIGHT-W) /2 

COLOUR=WHITE 

RECT(X,Y,W,W, TRUE ) 

RECT (X+W, Y+W,W,W, TRUE) 

RECT (X-2, Y-2,W*2+4,W*2+4, FALSE) 

UPDATE 

COLOUR=BLACK 

FOR I=1 TO W STEP S LOOP 
SCROLLUP(X,Y,W,W*2,S) 
SCROLLDOWN (X+W, Y,W,W*2,S) 
UPDATE 
WAIT (0.01) 

REPEAT 

FOR I = 1 TO W STEP S LOOP 
SCROLLRIGHT (X, Y+W,W*2,W,S) 
SCROLLLEFT(X,Y,W*2,W,S) 
WAIT (0.01) 

UPDATE 

REPEAT 

END 


Associated 
SCROLLLEFT, SCROLLRIGHT, SCROLLUP 
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SEED 


Purpose 
Seed the random number generator. 


Syntax 
SEED=vaLue 


Description 
This can be assigned to initialise the random number 


generator, or you can read it to find the current seed. 


Example 

SEED=10 

PRINT RND(10@) 

SEED=10 

REM Will print the same number 
PRINT RND(10@) 

REM Will print a different number 
PRINT RND(10@) 

END 


Associated 
RND 
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SEEK 


Purpose 
Move the file pointer to any place in the file. 


Syntax 
SEEK (handLe, offset) 


Description 


The SEEK instruction moves the file pointer to any place in the 
file. It can even move the file pointer beyond the end of the file 
in which case the file is extended. The argument supplied to 
SEEK is an absolute number of bytes from the start of the file. If 
you are using random access files and want to access the 7th 
record in the file, then you need to multiply your record size by 
7 to get the final location to seek to. 


Example 

handle=OPEN("TestFile.txt") 

recSize = 20 

FOR recNo=@ TO 10 LOOP 
record$ = "Record " + STR$(recNo) 
pad = recSize - LEN(record$) 
PRINT# handle, record$;SPACE$(pad) 

REPEAT 

REM read the 7th record 

SEEK (handle, (recSize+1)*7) 

INPUT# handle, record$ 

PRINT record$ 

CLOSE(handle) 

END 


Associated 
CLOSE, EOF, FFWD, INPUT#, OPEN, PRINT#, REWIND 
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SENSEACCELX / Y / Z 


Purpose 
Returns the value of the Raspberry Pi senseHAT 
accelerometer. 


Syntax 

value=SENSEACCELX 
value=SENSEACCELY 
value=SENSEACCELZ 


Description 


The Raspberry Pi senseHAT has a number of built in 
sensors. The accelerometer can be accessed with this 
function. 


Example 


CLS 
LOOP 
PRINT “Sense Accelerometer X=”; senseAccelX 


PRINT “Sense Accelerometer Y=”; senseAccelY 
PRINT “Sense Accelerometer Z=”; senseAccelZ 
REPEAT 

END 


Associated 
senseCompass, senseGyro 
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SENSECLS 


Purpose 
Sets all of the LEDs on the Raspberry Pi senseHAT to off. 


Syntax 
SENSECLS 


Description 


Sets an RGB value of 0, 0, 0 to all of the matrix LEDs 
thereby clearing the display. 


Example 


CLS 
sensePlot (2,2) 


WAIT (1) 
senseCls 
END 


Associated 


sensePlot, senseRect, senseScroll, senseHFlip, 
senseVflip, senseRGBcolour, senseGetRGB, senseLine 
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SENSECOMPASSX / Y /Z 


Purpose 
Returns the value of the Raspberry Pi senseHAT 
compass. 


Syntax 

value=SENSECOMPASSX 
value=SENSECOMPASSY 
value=SENSECOMPASSZ 


Description 


The Raspberry Pi senseHAT has a number of built in 
sensors. The compass can be accessed with this function. 


Example 

CLS 

LOOP 

PRINT “Sense Compass X=”; senseCompassX 


PRINT “Sense Compass Y=”; senseCompassY 
PRINT “Sense Compass Z=”; senseCompassZ 
REPEAT 

END 


Associated 
senseAccel, senseGyro, 
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SENSEGETRGB 


Purpose 
Return the values used by a Raspberry Pi senseHAT LED 


Syntax 
SENSEGETRGB(xpos, ypos, red, green, blue) 


Description 


Returns the Red, Green and Blue values from a given LED 
at the specified matrix coordinates. It is possible to use 
this for collision detection in games using the senseHAT. 


Example 

CLS 

senseRGBcolour (@, @, 255) 
sensePlot (0, @) 
SenseGetRGB (0, 0, R, G, B) 
PRINT “Red=”; R 

PRINT “Green=”; G 

PRINT “Blue=”; B 

END 


Associated 


senseCls, sensePlot, senseRect, senseScroll, senseHFlip, 
senseVflip, senseRGBcolour, , senseLine 
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SENSEGYROX / Y /Z 


Purpose 
Returns the value of the Raspberry Pi senseHAT gyro. 


Syntax 

value=SENSEGYROX 
value=SENSEGYROY 
value=SENSEGYROZ 


Description 


The Raspberry Pi senseHAT has a number of built in 
sensors. The gyro can be accessed with this function. 


Example 

CLS 

LOOP 

PRINT “Sense Gyro X=”; senseGyrox 
PRINT “Sense Gyro Y=”; senseGyroY 
PRINT “Sense Gyro Z=”; senseGyroZ 
REPEAT 

END 


Associated 
senseAccel, senseCompass 
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SENSEHEIGHT 


Purpose 
Returns the value of the Raspberry Pi senseHAT height 
sensor. 


Syntax 
value=SENSEHEIGHT 


Description 


The Raspberry Pi senseHAT has a number of built in 
sensors. Height above sea level can be accessed with this 
function. Note, this does not work well indoors. 


Example 

CLS 

LOOP 

PRINT “Height”; senseHeight 


REPEAT 
END 


Associated 
senseHumidity, sensePressure, senseTemperature 
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SENSEHFLIP 


Purpose 
Horizontally flips the Raspberry Pi senseHAT LED matrix. 


Syntax 
SENSEHFLIP 


Description 


Reverses (flips) the LED matrix display horizontally. 


Example 

CLS 
SenseRGBcolour(255,0,0) 
senseLine(0,0,90,7) 
SenseRGBcolour(@, 255, 0) 
senseLine(@,7,7,7) 

LOOP 

senseHflip 

WAIT(1) 

SenseVflip 

WAIT(1) 

END 


Associated 


senseCls, sensePlot, senseRect, senseScroll, senseVflip, 
senseRGBcolour, senseGetRGB, , senseLine 
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SENSEHUMIDITY 


Purpose 
Returns the value of the Raspberry Pi senseHAT 
humidity sensor. 


Syntax 
value=SENSEHUMIDITY 


Description 


The Raspberry Pi senseHAT has a number of built in 
sensors. Humidity can be accessed with this function. 


Example 

CLS 

LOOP 

PRINT “Humidity”; senseHumidity 
REPEAT 

END 


Associated 
senseHeight, sensePressure, senseTemperature 
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SENSELINE 


Purpose 
Lights a line on the Raspberry Pi senseHAT LED matrix. 


Syntax 
SENSELINE(xX1, y1, x2, y2) 


Description 


Sets the RGB values, defined by senseRGBcolour, to a line 
of LEDs on the Raspberry Pi senseHAT LED matrix. The 
line is displayed from x1, y1 to x2, y2. 


Example 

CLS 
SenseRGBcolour(255,0,@) 
senseLine(0,0,9,7) 
SenseRGBcolour(@, 255,0) 
senseLine(@,7,7,7) 

LOOP 

senseHflip 

WAIT(1) 

SenseVflip 

WAIT(1) 

END 


Associated 


senseCls, sensePlot, senseRect, senseScroll, senseVflip, 
senseRGBcolour, senseGetRGB 


Functions, Constants & Procedures 


SENSEPLOT 


Purpose 
Lights an LED on the Raspberry Pi senseHAT LED matrix. 


Syntax 
SENSEPLOT(xpos, ypos) 


Description 


Sets the RGB values, defined by senseRGBcolour, to a 
single LED on the Raspberry Pi senseHAT LED matrix. 


Example 

CLS 
SenseRGBcolour(255,0, 0) 
sensePlot (0,0) 
SenseRGBcolour(@, 255, 0) 
sensePlot (7,7) 

END 


Associated 


senseCls, senseHflip, senseRect, senseScroll, senseVflip, 
senseRGBcolour, senseGetRGB, senseLine 
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SENSEPRESSURE 


Purpose 
Returns the value of the Raspberry Pi senseHAT air 
pressure sensor. 


Syntax 
value=SENSEPRESSURE 


Description 


The Raspberry Pi senseHAT has a number of built in 
sensors. Air pressure can be accessed with this function. 


Example 


CLS 
LOOP 
PRINT “Pressure”; sensePressure 


REPEAT 
END 


Associated 
senseHumidity, senseHeight, senseTemperature 
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SENSERECT 


Purpose 
Lights a rectangle on the Raspberry Pi senseHAT LED 
matrix. 


Syntax 
SENSERECT(xpos, ypos, width, height, fill) 


Description 


Sets the RGB values, defined by senseRGBcolour, to a 
rectangle of LEDs on the Raspberry Pi senseHAT LED 
matrix. The rectangle is displayed from xpos, ypos with a 
width and height as specified. Fill can be either 0 for an 
outline or 1 for filled in. 


Example 

CLS 
SenseRGBcolour(255,0, 0) 
senseRect(0,0,7,7,1) 
SenseRGBcolour(@, 255, 0) 
senseRect(0,0,7,7,0) 
END 


Associated 


senseCls, sensePlot, senseLine, senseScroll, senseVflip, 
senseRGBcolour, senseGetRGB 


ry | ont F main index 101 
mm op 


SENSERGBCOLOUR 


Purpose 


Set the Red, Green and Blue values used by a Raspberry 
Pi senseHAT LED. 


Syntax 
SENSERGBCOLOUR(red, green, blue) 


Description 


Sets the Red, Green and Blue values to be used by the 
senseHAT FUZE BASIC drawing commands. 


Example 
CLS 
senseRGBcolour (255, @, @) 


sensePlot (0, @) 
senseRGBcolour (@, 255, @) 
sensePlot (3, 3) 
senseRGBcolour (@, @, 255) 
sensePlot (7, 7) 

END 


Associated 


senseCls, sensePlot, senseRect, senseScroll, senseHFlip, 
senseVflip, senseLine, senseGetRGB 
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SENSESCROLL 


Purpose 
Scrolls the Raspberry Pi senseHAT LED matrix. 


Syntax 
SENSESCROLL(dtirectton, direction) 


Description 
Shifts the Raspberry Pi senseHAT LED matrix in the 
specified direction by the number of pixels indicated. 


Example 

senseCLS 

sensePlot (2, 2) 

sensePlot (2, 3) 

LOOP 

SenseScroll (@, 2) // two up 
WAIT(@.1) 

SenseScroll (2, @) // two right 
WAIT(@.1) 

SenseScroll (@, -2) // two down 
WAIT(@.1) 

SenseScroll (-2, @) // two left 
WAIT(@.1) 

REPEAT 

END 


Associated 


senseCls, sensePlot, senseRect, senseRGBcolour, 
senseHFlip, senseVflip, senseLine, senseGetRGB 
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SENSETEMPERATURE 


Purpose 
Returns the value of the Raspberry Pi senseHAT heat 
sensor. 


Syntax 
value=SENSETEMPERATURE 


Description 


The Raspberry Pi senseHAT has a number of built in 
sensors. Temperature, in degrees, can be accessed with 
this function. 


Example 

CLS 

LOOP 

PRINT “Temperature”; senseTemperature 


REPEAT 
END 


Associated 
senseHumidity, senseHeight, sensePressure 
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SENSEVFLIP 


Purpose 
Vertically flips the Raspberry Pi senseHAT LED matrix. 


Syntax 
SENSEHFLIP 


Description 


Reverses (flips) the LED matrix display vertically. 


Example 

CLS 
SenseRGBcolour(255,0, 0) 
senseLine(0,0,0,7) 
SenseRGBcolour(@, 255, 0) 
senseLine(®,7,7,7) 

LOOP 

senseHflip 

WAIT(1) 

SenseVflip 

WAIT(1) 

END 


Associated 


senseCls, sensePlot, senseRect, senseScroll, senseVflip, 
senseRGBcolour, senseGetRGB, senseLine 
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SETCHANVOL 


Purpose 
Set the volume of a sound sample. 


Syntax 
SETCHANVOL (channeL , voLume) 


Description 

Sets the sound sample playback volume on the specified 
channel where volume is a percentage of the maximum 
(0-100) 


Example 

channel=@ 

chomp=LOADSAMPLE (""pacman_chomp.wav" ) 

FOR volume=1@ TO 10@ STEP 10 LOOP 
SETCHANVOL (channel, volume) 
PLAYSAMPLE(chomp, @,@) 
WAIT(1) 

REPEAT 

END 


Associated 


LOADSAMPLE, PAUSECHAN, PLAYSAMPLE, RESUMECHAN, 


STOPCHAN 
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SETMODE 


Purpose 
Set display width and height 


Syntax 
SETMODE( width, height ) 


Description 
Sets the display width and height to the specified. It is 
generally sensible to use standard screen display sizes 


Example 

SETMODE( 1280, 72@ ) 

PRINT "Hello World" 

WAIT( 2 ) 

SETMODE( 640, 482 ) 

PRINT "Hello Another World" 
END 


Associated 
GHEIGHT, GWIDTH 
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SETMOUSE 


Purpose 
Move the mouse pointer to the specified point. 


Syntax 
SETMOUSE (xpos, ypos ) 


Description 
Moves the mouse pointer to the screen coordinate (xpos,ypos) 


Example 

CLS 
MOUSEON 

COLOUR=WHITE 
RECT(100,100,150,50, TRUE ) 
INK=BLACK 

PAPER=WHITE 

PRINTAT(7,38); PRINT "Click Me" 
UPDATE 

Clicked=FALSE 

LOOP 

GETMOUSE(X,Y,Z) 

IF Z <> @ THEN 

IF (X > 100 AND X < 250) THEN 

IF (Y > 100 AND Y < 150) THEN 
Clicked=TRUE 
ENDIF 
ENDIF 

ENDIF 

REPEAT UNTIL Clicked 
SETMOUSE (GWIDTH/2, GHEIGHT/2) 
END 


Associated 
GETMOUSE, MOUSEOFF, MOUSEON, MOUSEX, MOUSEY 


mm 2) @ LF) 


Functions, Constants & Procedures 


SETMUSICVOL 


Purpose 
Sets the music playback volume. 


Syntax 
SETMUSICVOL (Level) 


Description 
Sets the music playback volume where /evel is a 
percentage of the maximum (0-100) 


Example 
handle=LOADMUSIC("takeoff.wav" ) 
SETMUSICVOL (70) 
PLAYMUSIC(handle, 1) 


Associated 
LOADMUSIC, PAUSEMUSIC, RESUMEMUSIC, STOPMUSIC 
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SETSPRITEALPHA 


Purpose 
Sets the transparency of a sprite 


Syntax 
SETSPRITEALPHA( sprite, alpha ) 


Description 


Sets how transparent a sprite is. An alpha of 0 means it's 
invisible and 255 means it's completely opaque, or solid. 


Example 

pic = NEWSPRITE( 1 ) 

LOADSPRITE( "/usr/share/fuze/logo. bmp", 
pic, @ ) 

FOR alpha = @ TO 255 LOOP 
SETSPRITEALPHA( pic, alpha ) 


PLOTSPRITE( pic, GWIDTH / 2, GHEIGHT / 2, @ 


) 
UPDATE 


REPEAT 
END 


Associated 
GETSPRITEH, GETSPRITEW, LOADSPRITE, NEWSPRITE, 


PLOTSPRITE, SETSPRITEANGLE, SETSPRITEFLIP, 
SETSPRITEORIGIN, GETSPRITEX, GETSPRITEY 
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SETSPRITEANGLE 


Purpose 
Rotate a sprite to the given angle 


Syntax 
SETSPRITEANGLE( sprite, angle ) 


Description 
Use to rotate the specified sprite to the given angle in 
degrees. 0 is default. 


Example 

pic = NEWSPRITE( 1 ) 

LOADSPRITE( "/usr/share/fuze/logo.bmp", 
pic, @ ) 

FOR angle = @ TO 360 LOOP 
SETSPRITEANGLE( pic, angle ) 


PLOTSPRITE( pic, GWIDTH / 2, GHEIGHT / 2, @ 


) 
UPDATE 


REPEAT 
END 


Associated 
GETSPRITEH, GETSPRITEW, LOADSPRITE, NEWSPRITE, 


PLOTSPRITE, SETSPRITESIZE, SETSPRITEFLIP, 
SETSPRITEORIGIN, GETSPRITEX, GETSPRITEY 
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SETSPRITEFLIP 


Purpose 
Mirror a sprite in the specified direction 


Syntax 
SETSPRITEFLIP( sprite, flip ) 


Description 
Graphically mirrors (flips) the specified sprite. 


O Reset to default 

1 mirrored vertically 

2 mirrored horizontally 

3 mirrored vertically & horizontally 


Example 

pic = NEWSPRITE( 1 ) 
LOADSPRITE("/usr/share/fuze/logo.bmp",pic, @) 
PLOTSPRITE(pic, gWidth / 2, gHeight / 2, @) 
FOR a=3 TO @ step -1 LOOP 

SETSPRITEFLIP( pic, a ) 

UPDATE 

WAIT( 1 ) 

REPEAT 


Associated 
GETSPRITEH, GETSPRITEW, LOADSPRITE, NEWSPRITE, 


PLOTSPRITE, SETSPRITEANGLE, SETSPRITESIZE, 
SETSPRITEORIGIN, GETSPRITEX, GETSPRITEY 
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SETSPRITEORIGIN 


Purpose 
Sets the anchor point of a sprite 


Syntax 
SETSPRITEorigin( sprite, xpos, ypos ) 


Description 


Use to set the origin of a specified sprite. When plotting a 
sprite its default origin is bottom left. You can change this to 
any point on the sprite. This example sets it to the middle. 


Example 

pic = NEWSPRITE( 1 ) 

LOADSPRITE( "“logo.png", pic, @ ) 
LOOP 

SETSPRITEORIGIN( pic, 0, ® ) 
Plotsprite( pic, @, @, @) 

Update 

Wait(1) 
MiddlexX=GETSPRITEW(pic)/2 
MiddleY=GETSPRITEH(pic)/2 
SETSPRITEORIGIN( pic, MiddleX, Middley ) 
PLOTSPRITE( pic, @, @, @) 

UPDATE 

REPEAT 


Associated 


GETSPRITEH, GETSPRITEW, LOADSPRITE, NEWSPRITE, PLOTSPRITE, 
SETSPRITEANGLE, SETSPRITEFLIP, SETSPRITESIZE, GETSPRITEX, GETSPRITEY 
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SETSPRITESIZE 


Purpose 
Change the size of a sprite 


Syntax 
SETSPRITESIZE( sprite, size ) 


Description 

Sets the sprite to the specified size in percent. 100 is the 
default, therefore 50 is half the size and 300 is three times 
as big as the original. 


Example 

pic = NEWSPRITE( 1 ) 
LOADSPRITE("/usr/share/fuze/logo.bmp",pic, @) 
FOR angle = 5@ TO 20@ LOOP 

SETSPRITESIZE( pic, size ) 

PLOTSPRITE( pic, GWIDTH / 2, GHEIGHT / 2, @) 
UPDATE 

REPEAT 

END 


Associated 
GETSPRITEH, GETSPRITEW, LOADSPRITE, NEWSPRITE, 


PLOTSPRITE, SETSPRITEANGLE, SETSPRITEFLIP, 
SETSPRITEORIGIN, GETSPRITEX, GETSPRITEY 
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SETSPRITETRANS 


Purpose 
Set a transparency colour for a given sprite and its sub- 
sprites. 


Syntax 
SETSPRITETRANS(spriteId, Red, Green, Blue) 


Description 

If you specify a transparency colour for a sprite then any 
pixels in the sprite that are this colour will be transparent 
i.e. They will show as the background colour. This allows a 
sprite to pass over a background image without blocking it 
out. You need to load the sprite files first before setting 
the transparency colour. 


Example (overleaf) 
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SETSPRITETRANS Example 


CLS 

RGBCOLOUR(247, 247, 247) 

RECT(5@, 5@, 101, 101, TRUE) 

COLOUR = YELLOW 

CIRCLE(100, 100, 5@, TRUE) 

SAVEREGION("s3.bmp", 5@, 50, 101, 101) 

CLs? 

COLOUR = RED 

MidY = GHEIGHT / 2 

FOR X = @ TO GWIDTH STEP 100 LOOP 
RECT(X, MidY - 50, 50, 200, TRUE) 

REPEAT 

COLOUR = Black 

s1 = NEWSPRITE(1) 

LOADSPRITE("s3.bmp", s1, @) 

SETSPRITETRANS(S1, 247, 247, 247) 

FOR X = @ TO gWidth STEP 1@ LOOP 
PLOTSPRITE(s1, X, GHEIGHT / 2, @) 
UPDATE 
WAIT (0.0005) 

REPEAT 

END 


Associated 
GETSPRITEH, GETSPRITEW, LOADSPRITE, NEWSPRITE, 
PLOTSPRITE, RGBCOLOUR 
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SGET 


Purpose 
Read a byte from a serial port. 


Syntax 
byte=SGET(handLe) 


Description 

Fetch a single byte of data from an open serial port and 
return the data as a number. This function will pause 
program execution for up to 5 seconds if no data is 
available. If there is still not data after 5 seconds, the 
function will return -1. 


Example 

REM Read a byte from a serial port 
arduino=SOPEN("/dev/ttyUSB@", 115200) 
byte=SGET (arduino) 

PRINT byte 

SCLOSE(arduino) 

END 


Associated 
SCLOSE, SGETS, SOPEN, SPUT, SPUTS, SREADY 
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SGET$ 


Purpose 
Read a character from a serial port. 


Syntax 
character=SGET$(handLe) 


Description 

Fetch a single byte of data from an open serial port and 
return the data as a single character string. This function 
will pause program execution for up to 5 seconds if no 
data is available. If there is still not data after 5 seconds, 
the function will return an empty string. 


Example 

REM Read a character from a serial port 
arduino=SOPEN("/dev/ttyUSB@", 115200) 
char$=SGET$(arduino) 

PRINT char$ 

SCLOSE(arduino) 

END 


Associated 
SCLOSE, SGET, SOPEN, SPUT, SPUTS, SREADY 
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SGN 


Purpose 
Returns the sign of the specified number. 


Syntax 
sign=SGN(number) 


Description 
Returns -1 if the number is negative, 1 otherwise. (Zero is 
considered positive) 


Example 

REM Prints 1 
PRINT SGN(10@) 
PRINT SGN(@) 
REM Print -1 
PRINT SGN(-5) 
END 


Associated 
ABS 
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SHOWKEYS 


Purpose 
List the function key definitions 


Syntax 
SHOWKEYS 


Description 

It is possible to set the 12 function keys at the top of the 
keyboard to user defined values. This command will show 
what the current definitions are. By default function key 
F2 is defined to enter the EDIT command and F3 the RUN 
command but it is possible to overwrite these. 


Example 

REM Set key F5 to clear screen 
keyF5$ = "CLS\n" 

SHOWKEYS 
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SIN 


Purpose 
Returns the sine of the given angle. 


Syntax 
sine=SIN(angLe) 


Description 

Returns the sine of the argument angle in radians. This is 
the ratio of the side of a right angled triangle, that is 
opposite to the angle, to the hypotenuse (the longest 
side). 


Example 

REM Draw an ellipse in the screen centre 

CLS 

DEG 

FOR Angle=@ TO 36@ LOOP 
Xpos=100*COS(Angle)+GWIDTH/2 
Ypos=50*SIN(Angle)+GHEIGHT/2 
PLOT (Xpos, Ypos) 

REPEAT 

END 


Associated 
ASIN, ATAN, COS 
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SOFTPWMWRITE 


Purpose 
Synthesize Pulse Wave Modulation to the specified GPIO 


pin. 


Syntax 
SOFTPWMWRITE (pinNo, value ) 


Description 

This enables you to simulate an analog output. For example 
instead of an LED being just on or off you can make it appear 
brighter or dimmer. The pinNo parameter is the number of the 
GPIO output pin. This must first be set to pinSoftPwm. The 
value parameter is a percentage (0-100). 


Example 

REM Connect an LED to GPIO pin @ 

PINMODE (@, PINSOFTPWM) 

FOR I=@ TO 10@ LOOP 
SOFTPWMWRITE (0,1) 
WAIT(@.1) 

REPEAT 

FOR I=100 to @ STEP -1 LOOP 
SOFTPWMWRITE (0,1) 
WAIT(@.1) 

REPEAT 

END 


Associated 
PINMODE 
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SOPEN 


Purpose 
Opens a serial device and makes it available for use. 


Syntax 
handLe=SOPEN($device, speed) 


Description 

This opens a serial device and makes it available for our 
use. It takes the name of the serial port and the speed as 
an argument and returns a number (the handle) of the 
device. We can use this handle to reference the device 
and allow us to open several devices at once. 

The following baud rates are recognised: 50, 75, 110, 134, 
150,200, 300, 600, 1200, 1800, 2400, 19200, 38400 
57600, 115200 and 230400, but do check your local PC 
and devices capabilities. The device is always opened with 


the data format set to 8 data bits, 1 stop bit and no parity. 


All handshaking is turned off. 


Example 

REM Read a byte from a serial port 
arduino=SOPEN("/dev/ttyUSB@", 115200) 
byte=SGET (arduino) 

SCLOSE(arduino) 

END 


Associated 
SCLOSE, SGET, SGETS, SPUT, SPUTS, SREADY 
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SOUND 


Purpose 
Play a synthesised sound with the specified parameters 
(emulates BBC BASIC SOUND command). 


Syntax 
sound(channeL ,ampLitude, pitch, duration) 


Description 


The channel is 0 to 3 with O being for white noise (static). The 
amplitude goes from 0 to -15 where O is silent and -15 is full 
volume (-7 being half volume and so on). The duration is in 
20ths of a second, so 20 represents one second, 10 half a 
second and so on. The pitch values are taken from a table 
which can be found at the end of the manual but, middle C has 
a value of 53 and each note is 4 away from the next. Note that 
when used with a sound envelope amplitude is replaced by 
the envelope number. 


Example 
Channel=1 
Volume=-10 
FOR Note=1 TO 5 LOOP 
READ Frequency, Duration 
SOUND (Channel, Volume, Frequency, Duration) 
REPEAT 
END 
DATA 89, 20, 97, 20, 81, 20, 33, 20, 61, 40 


Associated 
ENVELOPE, TONE 
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SPACE$ 


Purpose 
Returns a blank string of the specified length. 


Syntax 
blLankstring=SPACE$(number) 


Description 


Returns a string of blank spaces number characters long. 


Example 

Blank$ = SPACE$(100) 

FOR I=1 TO 2@ LOOP 
PRINT Blank$ 

REPEAT 

END 
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SPRITECOLLIDE 


Purpose 
Detect a sprite collision (fast bounding box) 


Syntax 
coLListon=SPRITECOLLIDE (target) 


Description 

Returns the sprite index of the first sprite that the sprite 
index target has collided with, or -1 if there is no collision. 
It only checks the current sprite location and this is only 
updated after a screen update LOOP so it is possible to call 
PLOTSPRITE() and have a sprite overlap but it not be 
detected until after the update has happened on screen. 
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Example 

CLS 

RGBCOLOUR (254, 254,254) 

RECT(50,50,101,101, TRUE) 

COLOUR=YELLOW 

CIRCLE(100,100,50, TRUE) 

SAVEREGION("si1.bmp",50,50,101,101) 

COLOUR=RED 

CIRCLE(100,100,50, TRUE) 

SAVEREGION("s2.bmp",50,50,101,101) 

CLS2 

S1=NEWSPRITE(1) 

S2=NEWSPRITE(1) 

LOADSPRITE("si.bmp",s1, 0) 

LOADSPRITE("s2.bmp",s2,0) 

FOR X=@ TO GWIDTH STEP 1 LOOP 
PLOTSPRITE(s1,X, 200, 0) 
PLOTSPRITE(s2,GWIDTH-X-100, 200,0) 
IF SPRITECOLLIDE (s2) <> -1 THEN BREAK 
UPDATE 
WAIT (@.0005 ) 

REPEAT 

END 


Associated 
GETSPRITEH, GETSPRITEW, HIDESPRITE, LOADSPRITE, 


NEWSPRITE, PLOTSPRITE, SPRITECOLLIDEPP 
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SPRITECOLLIDEPP 


Purpose 
Detect a sprite collision (pixel perfect) 


Syntax 
coLListon=SPRITECOLLIDEPP( target ,accuracy) 


Description 


This is a slower but more accurate version of SpriteCollide. 


It first does do a simple bounding box test then checks 
row at atime. The accuracy parameter is how many pixels 
to skip both horizontally and vertically. This is from 1 to 
16, where 1 is "perfect" and greater than 1 is less 
accurate, but faster. This will affect the amount of visible 
overlap you get before a collision is detected. 
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Example 

CLS 

RECT(50,50,101, 101, TRUE) 

COLOUR=YELLOW 

CIRCLE(100,100,50, TRUE) 

SAVEREGION("si1.bmp", 50,508,101, 101) 

COLOUR=RED 

CIRCLE(100,100,50, TRUE) 

SAVEREGION(""s2. bmp", 50,508,101, 101) 

CLS2 

S1=NEWSPRITE(1) 

S2=NEWSPRITE(1) 

LOADSPRITE("si.bmp",s1,@) 

LOADSPRITE("s2.bmp", 52,0) 

FOR X=@ TO GWIDTH STEP 1 LOOP 
PLOTSPRITE(s1,X, 200, 0) 
PLOTSPRITE(s2,GWIDTH-X-100@, 200, 0) 
IF SPRITECOLLIDEPP(s2,1) <> -1 THEN BREAK 
UPDATE 

REPEAT 

END 


Associated 
GETSPRITEH, GETSPRITEW, HIDESPRITE, LOADSPRITE, 


NEWSPRITE, PLOTSPRITE, SPRITECOLLIDE 
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SPRITEOUT 


Purpose 
Find out if a sprite is off screen 


Syntax 
resuLt = SPRITEOUT( sprite ) 


Description 
If the sprite is off screen then result is true otherwise it is 
false. 


Example 

pic = NEWSPRITE( 1 ) 
LOADSPRITE("/usr/share/fuze/logo.bmp",pic, @) 
PLOTSPRITE( pic, GWIDTH / 2, GHEIGHT / 2, @) 
WHILE NOT SPRITEOUT( pic ) LOOP 
ADVANCESPRITE( pic, 2 ) 

UPDATE 

REPEAT 

PRINT "GONE!" 

END 


Associated 
HIDESPRITE, PLOTSPRITE 
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SPUT 


Purpose 
Send a byte to an open serial port. 


Syntax 
SPUT(ardutno, byte) 


Description 
Send a single byte of data to an open serial port. 


Example 

REM Write a byte to a serial port 
arduino=SOPEN("/dev/ttyUSB@", 11520) 
SPUT(arduino, 52) 

SPUT(arduino, 5@) 

SCLOSE(arduino) 

END 


Associated 
SCLOSE, SGET, SGETS, SOPEN, SPUTS, SREADY 
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SPUT$ 


Purpose 
Send a character string to an open serial port. 


Syntax 
SPUT$(arduino, string) 


Description 


Send a string of characters of data to an open serial port. 


Example 

REM Write a byte to a serial port 
arduino=SOPEN("/dev/ttyUSB@", 115200) 
SPUT$(arduino, "Hello" ) 
SCLOSE(arduino) 

END 


Associated 
SCLOSE, SGET, SGETS, SOPEN, SPUT, SREADY 
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SQRT 


Purpose 
Return the square root of the specified number. 


Syntax 
squareroot=SQRT (number) 


Description 

Returns the square root of the argument number. This is 
the opposite of multiplying a number by itself i.e. X = 
SQRT(X * X) 


Example 

foursquared=4*4 

PRINT SQRT(foursquared) 
END 
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SREADY 


Purpose 


Get the number of characters available to be read on an 


open serial port. 


Syntax 
count=SREADY (handLe) 


Description 

Returns the number of characters available to be read 
from an open serial port. This can be used to poll the 
device to avoid stalling your program when there is no 
data available to be read. 


Example 
REM Read a character from a serial port 
arduino=SOPEN("/dev/ttyUSB@", 115200) 
IF SREADY(arduino) THEN 
char$=SGET$(arduino) 
PRINT char$ 
ENDIF 
SCLOSE(arduino) 
END 


Associated 
SCLOSE, SGET, SGETS, SOPEN, SPUT, SPUTS 
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STOP 


Purpose 
Stop a running program. 


Syntax 
STOP 


Description 
Program execution is stopped with a message indicating 
the current line number. 


Example 
INPUT "Enter the Password: ", pass$ 
IF pass$<>"wibble" THEN 
PRINT "Password Incorrect" 
STOP 
ENDIF 
PRINT "Password Correct" 
END 


Associated 
CONT 
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STOPCHAN 


Purpose 
Stop the playing of a sound sample. 


Syntax 
STOPCHAN(handLe) 


Description 

This function stops the playing of the sound sample 
associated with the handle returned by LOADSAMPLE that 
has been started using PLAYSAMPLE. It cannot be resumed 
once stopped. 


Example 

channel=@ 

volume=70 

SETCHANVOL (channel, volume) 
intro=LOADSAMPLE ("pacman_intro.wav") 
PLAYSAMPLE (intro, channel, 0) 

WAIT(3) 

STOPCHAN( intro) 

END 


Associated 
LOADSAMPLE, PAUSECHAN, PLAYSAMPLE, RESUMECHAN, 


SETCHANVOL 
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STOPMUSIC 


Purpose 
Stop music playing completely. 


Syntax 
STOPMUSIC 


Description 
Stops a playing music track which cannot then be 
resumed. 


Example 
handle=LOADMUSIC("takeoff.wav" ) 
SETMUSICVOL (70) 
PLAYMUSIC(handle, 1) 

STOPMUSTC 


Associated 
LOADMUSIC, PAUSEMUSIC, RESUMEMUSIC, 


SETMUSICVOL 
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STR$ 


Purpose 
Returns a string version of the supplied number. 


Syntax 
string$=STR$ (number) 


Description 

Returns a string in the decimal (base 10) representation of 
number. This is useful if you want to append a number to 
a string. This is the opposite of the VAL function. 


Example 
PRINT "The Answer is "+STR$(42) 
END 


Associated 
VAL 
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SWAP 


Purpose 
Swap the value of two variables. 


Syntax 
SWAP (vaLue1, value2) 


Description 

This swaps the value of the 2 variables round. Both 
arguments must be the same type - i.e. Both numeric or 
both string. 


Example 

lowest=99 

highest=@ 

IF lowest>highest THEN 
SWAP (highest, lowest ) 

ENDIF 

PRINT "Lowest "; lowest 

PRINT "Highest ";highest 

END 
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SWITCH 


Purpose 
Test a value against many different values and execute 
different code. 


Syntax 
SWITCH (variable) 
{ CASE value {, value } 
commands 
ENDCASE } 
[ DEFAULT 
commands 
ENDCASE ] 
ENDSWITCH 


Description 

Simplify the writing of multiple IF... THEN... ELSE 
statements. Rules 

e Every SWITCH must have a matching ENDSWITCH. 
e Every CASE or DEFAULT statement must have a 
matching ENDCASE. 

e Statements after a CASE statement must not run-into 
another CASE. 

e The constants after the CASE statement (and the 
expression in the SWITCH statement) can be either 
numbers or strings, but you can’t mix both. 
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Example 
INPUT a 
SWITCH(a) 
CASE 1,2 
PRINT "You entered 1 or 2" 
ENDCASE 
CASE 7 
PRINT "You entered 7" 
ENDCASE 
DEFAULT 
PRINT "You entered something else" 
ENDCASE 
ENDSWITCH 
END 


Associated 
ELSE, IF THEN 
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TAN 


Purpose 
Return the tangent of the given angle. 


Syntax 
tangent=TAN(angLe) 


Description 

Returns the tangent of the angle in the current angle 
units. In a right-angled triangle the tangent of an angle is 
the ratio of the length of the opposite side to the length 
of the adjacent side. This is a measure of the steepness of 
an angle. 


Example 

DEG 

PRINT "Tangent of 45 degrees: "; TAN(45) 
PRINT "ArcTangent of 1: "3; ATAN(1) 

END 


Associated 
ACOS, ASIN, ATAN, COS 
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TANGLE 


Purpose 
Read or set the current angle of the turtle. 


Syntax 
angLe=TANGLE 
TANGLE=angLe 


Description 

This can be read or assigned to and represents the current 
angle of the turtle when using turtle graphics mode (in the 
current angle units) 


Example 

CLS 

ORIGIN(GWIDTH/2,GHEIGHT/2) 

CLOCK 

FOR I = 1 TO 6@ LOOP 
TANGLE = I 
MOVETO(@,@) 
PENDOWN 
MOVE (100) 

REPEAT 

END 


Associated 
LEFT, MOVE, MOVETO, PENDOWN, PENUP, RIGHT 
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THEIGHT 


Purpose 
The height in characters of the display. 


Syntax 
height=THEIGHT 


Description 
The height in characters of the display. 


Example 

CLS 

text$="This text is centred in the screen" 
HVTAB( (TWIDTH-LEN(text$) )/2, THEIGHT/2) 
PRINT text$ 

END 


Associated 
TWIDTH 
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TIME 


Purpose 
Find out how long the program has been running. 


Syntax 
time=TIME 


Description 
This returns a number which represents the time that 
your program has been running in milliseconds. 


Example 

REM Simple reaction timer 

WAIT (2) 

REM Make sure no key pressed 
WHILE INKEY<>-1 LOOP 

REPEAT 

stime=TIME 

PRINT "Go!" 

WHILE INKEY=-1 LOOP 

REPEAT 

etime = TIME 

PRINT "Your reaction time is "; 
PRINT etime-stime; " milliseconds" 
END 
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TIME$ 


Purpose 
Returns a string with the current time. 


Syntax 
now$=TIME$ 


Description 
This returns a string with the current time in the following 
format: HH:MM:SS. For example: 18:05:45. 


Example 

PRINT "The time now is "; 
PRINT TIME$ 

END 


Associated 
DATES 
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TONE 


Purpose 
Play a tone with the specified parameters. 


Syntax 
TONE (channeL , volume, frequency, duration) 


Description 

This plays a simple tone of the given frequency (1 to 
5000Hz), volume (%) and duration (0.01 to 20 seconds) on 
the given channel. 

You can play multiple tones by playing them one after the 
other and up to three tones can be played simultaneously 
on different channels. 

Channel 0 is white noise and the frequency has no bearing 
on the sound produced. 


Example 
Channel=1 
Volume=7@ 
FOR Note=1 TO 5 LOOP 
READ Frequency, Duration 
TONE (Channel, Volume, Frequency ,Duration) 
REPEAT 
END 
DATA 440, 1, 493, 1, 392, 1, 196, 1, 294 ,2 


Associated 
SOUND 
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TRIANGLE 


Purpose 
Draw a triangle on the screen. 


Syntax 
TRIANGLE (xposi1, ypos1, xpos2, ypos2, 
xpos3, ypos3, fill) 


Description 


Draws a triangle with its corners at the three given points. 


The final parameter, fill is either TRUE or FALSE, and 
specifies filled (TRUE) or outline (FALSE). 


Example 

LOOP 
COLOUR=RND(16) 
x1=RND(GWIDTH) 
X2=RND(GWIDTH) 
X3=RND(GWIDTH) 
y1=RND(GHEIGHT ) 
y2=RND(GHEIGHT ) 
y3=RND(GHEIGHT) 
f=RND(2) 
TRIANGLE (x1,y1,x2,y2,x3,y3,f) 
UPDATE 
IF INKEY<>-1 THEN BREAK 

REPEAT 

END 


Associated 
CIRCLE, ELLIPSE, RECT 
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TRUE 


Purpose 
Represents the logical "true" value. 


Syntax 
TRUE 


Description 

Represents a Boolean value that succeeds a conditional 
test. It is equivalent to a numeric value of 1 (in fact 
anything other than 0 evaluates to TRUE) 


Example 

condition=TRUE 

IF condition=TRUE THEN 
PRINT "Condition is TRUE" 

ENDIF 

PRINT condition 

END 


Associated 
FALSE 
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TWIDTH 


Purpose 
The width in characters of the display. 


Syntax 
width=TWIDTH 


Description 
The width in characters of the display. 


Example 

text$="This text is centred horizontally" 
HTAB=(TWIDTH-LEN(text$) )/2 

PRINT text$ 

END 


a nurag OSE 
UPDATEMODE 


Purpose 
Set the video update mode. 


Syntax 
UPDATEMODE=mode 


Description (overleaf) 
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UPDATEMODE Description 

The updateMode determines when the screen is redrawn. 
Redrawing the screen takes a little time and will slow 
down a program if you do it too often. The value of the 
mode parameter can be 0, 1, or 2 as follows: 

0- automatic updates do not happen. Nothing will be 
drawn on the screen until the UPDATE command is issued. 
1-This is the default mode whereby an UPDATE happens 
automatically when you output a new line, or the screen 
scrolls. 

2-The screen is updated after every PRINT instruction 
whether it takes a new line or not. 


Example 
CLS 
INPUT "Update Mode? ",mode 
IF mode>=@ AND mode<=2 THEN 
PRINT “Press space to exit" 
WAIT(1) 
UPDATEMODE=mode 
LOOP 
PRINT "Hello World "; 
REPEAT UNTIL INKEY=32 
UPDATE 
ELSE 
PRINT “Invalid Update Mode" 
ENDIF 
WAIT(1) 
END 


Associated 
UPDATE 
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UNTIL REPEAT UPDATE 


Purpose Purpose 
Loop until the specified condition is met. Update screen graphics. 
Syntax Syntax 
UNTIL condition LOOP UPDATE 

statements 
es j Description 

Graphics are drawn to a temporary screen buffer rather 

Description than the visible screen. The UPDATE command copies the 
Execute the statements zero or more times until the working area to the main display. An update is also 


performed if your program stops for input, or when you 


condition is TRUE (Not 0). PRINT 4 Hew line 


Because the test is done at the start of the loop the 


Example 
statements may not be executed at all REM Moire patterns 
LOOP 
Example CLS 
REM Print 1 to 10 COLOUR=RND(15)+1 
count=1 x=RND(GWIDTH) 
y=RND(GHEIGHT ) 
UT TE SOunt ie: POOR FOR w=@ TO GWIDTH-1 STEP 3 LOOP 
PRINT count LINE(x, y,W,®) 
count=count + 1 LINE(x,y,w, GHEIGHT-1) 
REPEAT REPEAT 
END FOR h=@ TO GHEIGHT-1 STEP 3 LOOP 
LINE(x,y,®,h) 
. LINE(x, y,GWIDTH-1, h) 
Associated REPEAT 
BREAK, CONTINUE, LOOP, LOOP REPEAT, FOR REPEAT, UPDATE 
REPEAT UNTIL, WHILE REPEAT be aaa 
Associated 
UPDATEMODE 
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VAL 


Purpose 
Returns the number represented by a character string. 


Syntax 
number=VAL(string$) 


Description 
Returns the number represented by stringS. This is the 
opposite of the STRS function. 


Example 

now$ =TIME$ 

hh=VAL(LEFT$(now$, 2)) 
mm=VAL(MID$(now$, 3, 2)) 
SS=VAL(RIGHT$(now$, 2) ) 
elapsed=hh*3600+mm*60+ss 
PRINT "Seconds since midnight: 
END 


3 elapsed 


Associated 
STRS 
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VLINE 


Purpose 
Draws a vertical line. 


Syntax 
VLINE (yposi1,ypos2, xpos) 


Description 
Draws a vertical line on column xpos, from row ypos1 to 
row ypos2. 


Example 

CLS 

COLOUR=red 

FOR xpos=@ TO GWIDTH STEP 100 LOOP 
VLINE(@, GHEIGHT, xpos) 

REPEAT 

UPDATE 

END 


Associated 
HLINE, LINE, LINETO 
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VTAB 


Purpose 


Set/Read the current text cursor vertical position. 


Syntax 
VTAB=vaLue 
vaLue=VTAB 


Description 


Set/Read the current text cursor vertical position. 


Example 

CLS 

FOR ypos = @ TO THEIGHT LOOP 
VTAB=ypos 
PRINT VTAB 

REPEAT 

VTAB=0 

END 


Associated 
HTAB, HVTAB 
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Functions, Constants & Procedures 


WAIT 


Purpose 
Waits for the specified time to elapse. 


Syntax 
WAIT (time) 


Description 

This waits (does nothing) for time seconds. This may be a 
fractional number, but the accuracy will depend on the 
computer you are running it on, however delays down to 
1/100th of a second should be achievable. 


Example 

REM COUNT 10 Seconds 

CLS 

Seconds = @ 

FOR I=1 TO 10 LOOP 
WAIT (1) 
Seconds=Seconds + 1 
HVTAB(10, 10) 

PRINT Seconds 

REPEAT 

PRINT "Elapsed "; TIME/1000 

END 
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Functions, Constants & Procedures 


WHILE REPEAT 


Purpose 
Loop while the specified condition is met. 


Syntax 

WHILE condition LOOP 
{statements} 

REPEAT 


Description 

Execute the statements zero or more times while the condition 
is TRUE (Not 0). Because the test is done at the start of the loop 
the statements may not be executed at all. 


Example 
handle=OPEN("whiletest.txt") 
FOR r=@ TO 10 LOOP 
PRINT# handle,"Record ";r 
REPEAT 
CLOSE (handle) 
handle = OPEN("whiletest.txt") 
WHILE NOT EOF(handle) LOOP 
INPUT# handle, record$ 
PRINT record$ 
REPEAT 
CLOSE (handle) 
END 


Associated 
BREAK, CONTINUE, LOOP, LOOP REPEAT, FOR REPEAT, 


REPEAT UNTIL, UNTIL REPEAT 
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Joystick and Gamepad commands 


listGamepads 

Immediate mode only. Displays a list of connected 
devices. 

numButtons( gamepad ) 

Returns the number of buttons on a specified device 
numAxes( gamepad ) 

Returns the number of analog axis on a specified device 
numHats( gamepad ) 

Returns the number of HATS on a specified device 
numGamepads 

Returns the number of devices connected 

getAxis( gamepad, axis ) 

Returns the value of a given axis on a specified device 
getButton( gamepad, button ) 

Returns the value of a given button on a specified device 
getHat( gamepad, hat ) 

Returns the value of a given HAT ona specified device 
SetupGamepad( gamepad ) 


Configure a specified device 
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ScanKeyboard values 


scanBackspace 
scanTab 
scanClear 
scanReturn 
scanPause 
scanEscape 
scanSpace 
scanExclaim 
scanQuoteDbl 
scanHash 
scanDollar 
scanAmpersand 
scanQuote 
scanLeftParen 
scanRightParen 
scanAsterisk 
scanPlus 
scanComma 
scanMinus 
scanPeriod 
scanSlash 
scan0O 


scanl1 
scan2 
scan3 
scan4 
scan5 
scan6 
scan7 
scan8s 
scan9 
scanColon 
scanSemiColon 
ScanLess 


ScanEquals 
scanGreater 


scanQuestion 
scanAt 
scanLeftBracket 
scanBackSlash 
scanRightBracket 
scanCaret 
ScanUnderscore 
scanBackQuote 
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scanA 
scanB 
scanC 
scanD 
scanE 
scanF 
scanG 
scanH 
scanl 
scanJ 
scanKk 
scanL 
scanM 
scanN 
scanO 
scanP 
scanQ 
scanR 
scanS 
scanT 
scanU 
scanV 


scanV 
scanW 
scanX 
scanY 


ScanZ 
scanDelete 


scanKPO 
scanKP1 
scanKP2 
scanKP3 
scanKP4 
scanKP5 
scanKP6 
scanKP7 
scanKP8 
scanKP9 
scanKpPeriod 
scanKpDivide 
scanKpMultiply 
scanKpMinus 
scanKpPlus 
ScanKpEnter 
ScanKpEquals 
scanUp 


scanDown 
scanRight 
scanLeft 
scanInsert 
scanHome 
scanEnd 
scanPageup 
scanPagedown 
scanF1 
scanF2 
scanF3 
scanF4 
scanF5 
scanF6 
scanF7 


ScanF8& 
scanF9 


scanF10 
scanF11 
scanF12 
scanF13 
scanF14 
ScanF15 
scanNumLock 


main index 


scanCapsLock 
scanScrolLock 
scanRShift 
scanLShift 
scanRCtrl 
scanLCtrl 
scanRAIt 
scanLAlt 
scanRMeta 
scanLMeta 
scanLSuper 
scanRSuper 
scanMode 
scanCompose 
scanHelp 
scanPrint 
scanSysReq 
scanBreak 
scanMenu 
scanPower 
scanEuro 
scanUndo 
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Notes & Octaves for Sound function 
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